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The. purpose ‘of this document is to ie tite. and Giecuss ae: Master 


Contret Program Il CMCP) for the B10CC machinese The concept and | 


design of the MCP witl be discussed and the — functional 
sHecitvedtrens of the MCP Ts operatiors wate. be catalogued. | 


The = sort» deta communications and data management systems will 
mot ke discussed in any deotn in. this document. Detailed 
descriptions of these features appear in other Burroughs 
“publications (See Related Documantaticr below). _ J oA 


HELATEC OOCUMERTATION 


—_— 2 ee . ». @ &*™ _ a Number 


 B1000 MCP Utilities i ee —.  PeSe 2212 5579 
$1000 Network Definition Panuuade: —— PeSe 2212 5223 
81060 Cata Management Syotens il o 3 mae 2212 5470 : 
Bt800781700 Sort. 2 f. PeSe 2201. 6752, 
81000 Software Operational Guide» oo 1068731 
These specifications are uritten for those people with | 
progréemming experience and a krowtedge cf basic software | 
concepts. Those unfamiliar with operating system design will 


gain insight into the 8urroughs philosophy of system management. 
Those individuals familiar with cperating systems of other | 


manutacturers or of other 3urrouchs machines witl gain an 
understanding of the Master Centrot Pregram implemented — 
eee certy for the Peenoas Bi0dogc. | | _ 


tie jaetuded Aig a mr ore are. brief descrigtions of 


various functions performed by the micro-coded 1/0 driver 
fOutires. | These same routines ere often referred to as. "GISM0* 
and “I/0 interpreter". The discussions are necessary for — 


completeness and fer a thorough understarding of the 81000 
‘i BRerating system af which the 1/0 driver 1s an integral parte — | 


MCP. II is a edu taret ‘supervisory pregram that assumes commons 


— Logically complex functions to simplify and expedite the tasks. of 
programming and system operation. Its most. Sapercant. eeCree 


inctuce oucn functions as: 


a 
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*  Schedulircr initiations runnings and termination of jobs 


* Froviding a symbolic means cf communicating with the system 
while shielding the user from the detait cf the hardware 


* Providing a family of common facilities such aS management 
cf input/output operations and file maintenance 


af Managing the system's resources fcr optimum utilization in a 
multitprocrammince environment 


2 MACEINE 


The &€1000 is a small-to~medium scales general purpose computer 
SyStefe Its distinguishing feature is its flexibility» made 
pessitle throuch interpretive pracessinge In any computer system 
arerpresentation of any process has two comporents: (1) a family 
of structures representing the state of that process» and (2) a 
series af operators able to manipuléete those structures. Until 
the acvent of fourth generation computers» doth components were 
represented in the machine hardwere itsetf. A compiler or 
language translator transformed the scurce cade (Ceege»r COBOL» 
FORTRFAND anto a “machine tanguage™ Cobject code) which was 
definec ir terms of the hardware architecture. 


For the set of processes able to be generated by any particular 
progréemmirg language» there exists a machine architecture which 
best represents those processesSe. For instances COBOL is a 
character~oriented language and cerforms decimal arithmetic 
exclusively.» fecause of its data maripulation features» it might 
best utilize a machine architecture with multi-address operators» 
capable of performing efficient “mcvese" “canpares»”™ and simple 
expression evaluation. On the cther hand» FORTRAN was designed 
to compute complex mathematical functionse- It favors a stack 
structure for parameter passinc and complex expression. 
evaluation. It perforas otnary arithmetic and noun prefer 30-7 
to 50-bit word sizes. | 


The cifficulty of designing a hardware structure capable of 
handling two such divergent languaces tn the most efficient 


Manner becomes apparent. It would Le possible» in principle at 
least» to design the hardware in such a way as to adequately 
represert both sets of structures. Fowever» this would prove ta 


be prchibitively expensive.- The typical apprceach» therefore» has 
been to either desigqn the hardware to favor one Language at. the 
expense of otters or to design a comprcmise structure capable of 
handling several languages» but none in the most efficient 
Manner. The wide. variety o f prograwning languages in current use 
has placed 4a great strain on the capacity of the hardware to 
ee execute code compiled from wet y different. Languagese 
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It is ta this problen that desicrers of fourth generation 
sOftwares and the G1C00 in particulars have addressed themselves. 
Rather than build a particular structure into the hardwares the 
concert af the “soft machine" hes heen developed whereby the 
ideal environment of structures and cherators is programmatically 
simulated. | 


The 61000 hardware was designed with as Little explicit structure 
as possible. Fecause memory may be addressed to the bit» no one 


structure is anherertly favored cver ary other. The only 
required structure is that which wilt allow the simulation of any 


"soft machine™. Thus the raraqe of Structures able to he 
represerted on the 61000 is untimitec. ty 


As stzeted previously» for every comciler tanguage there exists a 


machire architecture within which the algcrithms generated by 


that compiler will best rune Jn the 81000 this hypothetical 


ervircrment is called the “"S-machire". Ar S~machine has been 
aqefined for each language such that any frocess may be 
represented in its most effictent or fost natural form» 


unrestrained by any areatrery hardware configuration. 


Compiters on the 81900 generate code files which contain (1) the 
inforgation mecessary to tnitialize the appropriate S“machine at 
run time» and €2) the "S-cade™ to be executed on this S-machine. 
S-code is written in Slanguage» the machine Language for an 
S“machinee Execution is achievec by the S“code being 
intercreted»s an S~operator at a times by a micro~program catted 
an tnterpreter. : | . | 


SOFTHARE 
The tera "software™ » as used in this cocument>» refers to att 
progremming supplied by the Santa Rerbara Plants When the term 


4% used» it mest tikely is referring to programs that are written 


in a higher-level Language» This may rot always be the case» hut — 
typicelly» the term will refer to the compilers and utility 


phar one created ky the. Programming Activity. 
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The firmware consists of a set of interoreters» those portions of 
the MCP which are microtcoded and reside in an entity known as 
the MICRO/MCP» and a program called *GISMO". For each S~language 
a micro-codeca program called an interpreter acts upon the 
hardware and executes the compiled S~code as defined by the 
S"mactinee The 31000 software has been implemented in such a way 
that any number of interpretive .structures may be active in the 


System at any given” time. This as achieved by dynamically 
establishings upon, demand» the S-machine structure for any 
procesSe | 7 | . 


For instances the MCP» which is itself a programe is written in a 
high tevel language» SOL » that is desigred specifically for 
Wwritirg software. $It has its own optimum environment Cthe SDL 
Smachine) consisting of the structures and operators required 


for software apolicationse It has its own StlLanguage and its own 


intercreter Cthe SDL interpreter). funning simultaneously in the 
system may be another procram writter in a different language 
COeges COPOL). This prograw alsc has its cwn structure Cthe 


COBOL S-m@achine)ds» S~Language» and interpreter.» The systems when 


executing the MCP%s. supervisory functions» assumes the 
architecture cf the SEL S-machine ance when executing the COBOL 


gnstructionss takes on the COsB0L S~machire structuree This 


switching of interpreters and orocess environments is managed 
completely by the software and is invisible to the user of the 
machines f 3 7 : 


The E—10C€ MCP has actualty evolvec to its present State. 


Originally» alt functions of the MCP were coded in SDL. 
Beyginring with the 4.C release of the software» the most commonly 
used routines cf the MCP were written in micro~ code and placed in 
GISMQ. This resulted in substantial performance improvements. 
Beginning with the £.1 release of the softwares these commonty 
used routines were removed from GISMC and pieced in the ‘entity 
non ercued prexwe the MICRO/MCP. : 7 


These specifications have also avolved along with the MCP. Many 


of the furctiors described herein ere now performed by the 
MICRO“MCPs thcugh the function itself remains exactly the same as 
it was when it was performed by SDL code. Since this document 15 
jntenced to be a functional specification of the 51000 operating 
system» all MCP functions are described herein. Whether the 
function is erformed by SOL cace or by w#icro code should be 
completely transparent to the user. Actually» the functional 


result is the same for both» but the time and resource 


requiremerts are not identical. The ciffererce is therefore not 


always transparent. 
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Throuchout this document» the acrerym "MCP™ may oe referring toa 
the MICRU/MCP or to the SOL MCP. Ir cases whera the distinction 
1S tmportants» “MCP™ will not be usec but the two terms mentioned 


above will he. This document» then» will actuatly be a 


functional specification of the cperating system» as it was 
origirally intended ta hee though it will actuatly be describing 
two separate and distinct prograas. Since GISMO is also a 
critical part of the cperating ak the document may = atso 


touch upon POG vONs of GISMQ. 


GISMC ts a micro~coded family of critical routines common to all 
processeSe GISMO may also be referred to in this document = as 
"CSM">» an acronym for Centrat Service Module. It is a central 
module of service routines used by atl programs in the system and 
perfcrms three basic functions? 


le icone of controt Between att contending processes in the. 
systems : 
2e feccgnition and queueing of interrupts received from the [/u 


controls cr from other crocesses tn:the system» 


$e Initiation and management of the i/0 controls connected to 
the mwachiress» usually at the recuest of another process... 


Processor allocations the switching cf control between two or 
more processes» is haendted by the “Micro Scheduler” module in 


GISMG. This wodule may be thought cf as an “Cuter Loop". It has 
absolute control over the process which a he performed next on 


the Se 


Interrupt resolution conststs of routines which perform certain 
tuncticrs defending on the type ct interrurt and certain cther 


critical conditions. The interpreter in control senses’ the 
interrupt and catts upon GiSMO to take the required actione | 


GISMO's service request. module Csott I/0) performs the function 
of a hardware device capable of performing a memory access at the 
request cf ar I/0 control. An I/G control on the P1009 is a 
nardwere device which acts as an interface between soft I/0 and a 
peripheral devicee It requests access to memcry on behalf of the 
device and marayges the device itself. The collection of I/0 
controls is calied the I/70 sub-systen. | 


Typical déta transfer agerations invelve frequent but brief calts | 


upon soft 1/0 by the I/90 subtsysteme _ The firmware was designed 
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1m such a way that re etween the execution of any two Stoperators, 
the irterpreter in control wilt check a- flag in the processor 
Ccalled the Service Reque St 3it) te see if the I/0 sub-system is 
demancing attentions. If it iss the interpreter passes contrat to 


GISMO which performs the necessary memory access and returns 
contrci to the interpreter. | 
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Before proceeding with a detailed description. of what the MCP. 


does and how it goes about it» it will be necessary to define a 


number of terms and déta structures whose names are used 
familiarty throughout the document. The reacer should know the _ 


meanirgs of the terms» hut a thorouch understanding of the’ many 
diverse programming structures preserted. herein is not required. 
The structures are presented onty in the interests of 
completeness» and as a possible aid in understanding the 


narrative descriptions of the MCP*s furctions> presented tn the. 
tater sections Oo f the specification. 


MEMORY MANAGEMENT AND MEMORY LINKS 


The CP orgéenizes end allocates spéece in memory through the use 


additional set of descriptors ooint to the Links of the prior. 


availebte and next available tlocks of memory. Thus it 1s 
possitie to seerch all tinks or ortly those Links describing 


available memory.» A programmatic description ts given below: 


DEFINE MEMORY.LINK. SIZE NS HLa7 as 
DECLARE MEMODRYeLINK TEMPLATE SITCMEMCEY. LINK. SIZE)3 
DEFINE MEMORY.LINK.-DECLARATION AS 4 


DECLARE C1 DUMMY REMAPS MEMORY. LINK» 


2 VLeDISK | | «SK .ADR> 
e ML.G ROUP » | , 
7. ML.POINTER ADDRESS» 
27 ML.~JOG.NUMEER BITC16)» 
2 MLATYPE | |  ~BITC6)>» 
BML SAVE  . BITC1)>» 
2 ML.SIZE. | | BIT(24)> 
2 MLePRIORITY.FIELD BI TC30)> 
I MLeDKe INTERVAL BITC10)> 
7 MLeCURRENTsDKINT BITC10)> 
3 MLeINCOMING.PRIORITY BITCS)» 
7 MLeRESIDENCE PRIORITY  SITCS)»>~ 
4 MLeRP.WHOLE -BETC4)» 
4 MLORPeFRACTION  -BITCL)» 
2 MLeFRONT | BLTC24)> 
2 MLeBACK —— — BITC24)5— 
2 


MLUSAGE. “BLES —  BITC2)» 
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of fields known as memcry Links. Ezch Link immediately precedes 
the block of memory it describes ard includes such information © 
ass The size cf that block of mewnorys the type of use (Cif any) 
to which it is puts and pointers tc the immediately preceding 
and succeeding Linkse If the block of memory is classified as © 
available Ci.e.» not. currently in use by any process)» = an 
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3 ML»PREVIOUS. Sein cede Weeteis | 
7 ML»CURRENT.~SCAN.TOUCH | BITCLI Fas 


USEC ML.CISK 
 »oMLePOINTER. 

eMLeJOCBANUMSER 

eMLATYPE 

ePWVLASAVE 

eWLASIZE 

oML.~FRONT 

oML~BACK 

) OF MEMORY. LINK «DECLARATIONS 


DEFINE Q.MLeDECLARATION AS#OECLARE 

OL Q.MEMORY.LINK TEMPLATE 
02 FILLER — BITCMEMCRY. LINK. SIZED 
O2 GaML.FeAVE ADDRESS 
G2 Q.ML.E.AVL ADDRESS 


Ver» es % 


fe 


DEFINE a 
TAKE.LO : AS#HOM 
» TAKE.SRIGHTMCST © AS#1A 


DEFINE -&% TYPES FOR "ML.TYPE" 
| CCDE AS #O RX | | 


AVAILABLE AS = #242 
RNS AS 38% 
MCP.2TEMP AS HOHE 
USEReFILE AS #548% 
SEG-DICTV AS #682 
MICROCODE #742 
CICT.MASTER AS #82 
QUEUE .DIRECTORY «TYPE 
AS #94 


ee Ye &@ sie & 


» MSGeBUFFERY mr 
| AS #108 
2» MESSAGE.LIST»TYPE ~ 
AS #114. 

» 1GeBE.FORGOTTEN AS #122 

DATAsSEG AS #124 

DEMeSUFFER AS #1428— 
TERMINATING LINK AS #1SHL 

MCP.PERM AS #16#%— 
— «PSReMEM AS #L74Z 
 MCPeICAT = AS:- #18 #2 

DISKHEADER AS #1982 

PACK. MEM AS #208% 

SC«CNITNR AS #218%— 
 SCHED.MEM =AS #2282 

—SCRT*MEM AS #2382 
 £LCHAMEM = AS:-— #2 4#X | 
~MICROCODE.NON. OVERLAY ABLE AS H254% 


) we OU Re Ye ee 
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» @QLEUELAVL.BUF.V AS #26# 

, CMSeDISKeHDR AS#Z74Z | 

» D¥S.STRUCTURE AS#ZaR% 

» CMSeTEMP AS #298% 

»  CMSeGLOBALS AS #30#2% 

» OUMSeTEMP.LOCK.DESCR AS #314 

» XMeMEMORY AS 432¢ : 

» PERM.SPOSEUFF AS 4332 

: | 


"TEMPLATE" in the above description is defined as "REMAPS BASE". 
This is .not important to an uncerstandirg of memory” Link 
operations © "ADDRESS" is detinec in the MCP symbolic as 
“BITC24)". The word “ADDRESS” here is used as a denotation of 
memory addresse Hences "“ML.BACK" ir the description above is a 
pointer to the previous memory tink arc “MLeFRONT” is a pcinter 
to the succeeding Linke. = MLASIZE will contain the size of the 
area» in bits» and ML.GROUP is valic cnly if the area is in uSe.e 
MLe~POINTER will contain the memory address of the segment. 
dicticnary entry associated with this merory area. Segment 
dicticnaries are described in the rext section. ML.JOB.NUMBER 
will contain the job number of the program using the area. 
ML.SAVEr the description of which is defined as "“BOOLEAN»>” is set 
on af the memory area must be saved on disk before it is 
overlaid. a | | | 


As can be determined by adding the sizes of the various 
comporents» a memory Link requires 187 bits of storage spaces. 
Since memory is allocated dynamically» it is often difficult to 
predict with any degree of accuracy exactly hcw much memory wilt 
be recutred by any taske The sizes cf all memory tinks involved 
must te included in the calcutaticns. This is discussed further 
in a later paragraph. | 


SEGMENT DICTIONARIES AND SYSTEM QESCRIPIORS 


Virtual memory is supported Dy allowing process segmentation. By 
Se€gmenting code» data» and interpreters and dynamically moving a 
segmert into or out of memory as reaquireds the system is able to 
function as if it had “virtually infirite”™ memory capacity. The 
MCP manages this facility through three structures: Code Segment 
Dicticnaries» Cata Segment Dictionaries» and Interpreter Segment 
Dicticnaries. Each dictionary consists of a string of system 
descriptors each of which describes cne seqwent including its 
length» tocation and status- AS a segment is toved in or out of 
memory its dictionary entry is updated accordingly. 


At run -time the MCP creates the code and data segment 
Gicticnaries from information in the program's code file. The 
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interpreter dictionary» 


Clear/Start time. The 


run 


interereter seqment dictionary is created 
code file in the same manner and 


structure 
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from the interpreter 


is referenced by an entry in the 


fixed in memory at 


structure of the program contains 


pointers to the code and data segment cictionaries and an index 


into the interoreter cree ewan 


given below: 


DECLARE 


7 


A programmatic description is 


01 SYSTEMADESCRIPTOR TEMPLATE BIIUCSY»SIZE); 


DEFINE SY-DECLARATION AS #SY-DECLCSYSTEM-DESCRIPTORD 43% 
DEFINE SY~DECLCX) AS #DECLAREZ 


Gi DUMMY REMAPS XoZ- 


O02 SYeINeUSE 

O2 SY.-MEDIA 

02 SY-LOCK 

O02 SY.IN. PROCESS” 


O2 SY~INTTIAL 


O02 SY.FILE 


OZ SY-CKeFACTOR 
02 SY.SEG.PG | 
G2 SY.TYPE 


02 SY-ADDRESS 

- 03 FILLER 
03 SY.CORE 

02 SYsLENGTH 


BITC1)» 
BITC1)» 
BITC1)» 


BITC1)» 


BITC1 I» 


BITC)» 


BITC3) 
BITC7)> 
BITCA)» 


BITC36)> 


BITC12)> 
BITCZ4)» 
BITC24)3 


Been ea pte annie Set ea ee re 


NOUS WN HS 


TO HELP MEMORY MANAGEMENT 
O=DISK» 1=S“MEMORY 


TRUE IF THERE IS AN I/0 IN 
PROCESS FOR THE INFORMATION 


REPRESENTED 8Y THIS DESCRIPTCR. 


IF TRUE» "SY.CORE™ CONTAINS A 
POINTER TO THE 1/0 DESCRIPTOR. 
"ADDRESS" IS READ-ONLY MOTHER. 


COPY» HENCE IF "WRITE" THEN GET 


NEW DISK AND REPLACE ADDRESS. 
THE OBJECT OF THIS DESCRIPTOR 
IS A FILE WHOSE USERCOUNT MUST 
BE DECREMENTED WHEN THIS 
DESCRIPTOR IS RETIRED. 

MEMORY DECAY FACTOR 
MEMORY-ACTIVITY AUDITING 


UNITS FOR SY-LENGTH- 


BITS — 

DIGITS (4 BIT) | 
CHARACTERS (8 BIT) 
NORMAL DESCRIPTORS 
DISK SEGMENTS . 
SYSTEM DESCRIPTORS 
SYSTEM INTRINSIC 
INDIRECT REFERENCE ; 
ADDRESS GIVES RELATIVE 
DISPLACEMENT IN BITS 
CSIGNEND NUMBER). 

8= MICROS 


li 


ioui td wou it 


PORT» CHANNEL AND UNIT. 


CORE» OR ADDRESS WITHIN UNIT. 


NUMBER OF UNITS» AS DETERMINED 


BY SY.TYPE.. 


Ritts 
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ye 
> 
DEFINE ND.«DECLARATION AS# 
DECLARE 
Q1 DUMMY REMAPS NORMAL.DESCRIPTOR BITCND. SIZE» 
O2 NOmDKeFACTOR BITC3)> | 
O02 FILLER BITC6)>» 
O02 ND.CORE | BIT(C24)> 
02 NO.TYPE BiTC3)» 


O02 NDeLENGTH - BITCZ4) sf 


~SY-SI2ZE is defined in the MCP code as eighty. Hence etghty bits 
are required to contain one segment dictionary entry» or system 
descriptor. The use of the term “DESCRIPTOR” in 81000 
documentation is often misleading anc ambigucuse There are many 
different types of descriptors» all of which have different 
memory requirements and formatSe Consequently» system 
descriptors wilt always be referred to as such or as segment 
dicticnary entriese 7 


The comments on the various’ fields comprising the system 
descriptor are largely selfr-ex¢clanatory. Perhaps some 
explaration of setected fields weculd be bereficial» however. 
SYe-LOCK tis set true if the system descriptor describes a data 
field and if the interpreter is currently accessing the fieid. 
This as to évoid the situation which arises tin ae simple 
replacement statement where the sercing and receiving field are 
both in overtayable segments. In orcer to do the reptacement» 
both cata segments must be in memory simultaneously. 


SYeINITIAL is true for initiattzed data only. The most common 
case cf this cccurs when executing a CGBGL program and the 
programmer has used the value clause to initialize data fields 
and the data fielc itself is ir an overtlayable segment. 
SYeADCRESS may be either a disk or a memory adcresss depending on 
the setting of SY-MEDIA. If it is a memory address» the most. 
Significant twelve tits are igrorece If it is a disk address» 
the most significant twelve bits contain the ports channel and 
unit associated with the disk address. 


— ome ap <i a a <-> wns En TE Sh OR OND << ee ee A CIic Pe TEEN Ate DD we 


The B10G0 MCP maintains a List or directory of atl files on disk. 
file stored or disk has a unique nage» uhich way consist of up to 
three fields» each of which may corsist of up to ten characters. 
Associated with each file on disk is én item catled a “Disk File 
Header". The disk file header serves essentially to describe the | 
file. All of this is described in cetail in later sectionse — 
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This brief discussion is being included at this point to 
facilitate the following discussicns cnr interpreters. 


included in the disk file header is a field which denotes” the 
type of file. There are separate type numbers for data files» 
code filese interpreters» and so ferth. Cece files (programs) 
and interpreters are further described by the first disk segment 
contained in the file. This seqmert is called the "Program 
Parameter Block” or the “Interpreter Parameter Block", 
respectively. A detailed descrinticn of the program paramter 
block ws presented in a tater section. A orogrammatic 


description of the interpreter parameter block is presented 
belaw. | | 


DEFINE IPE.~NECLARATION AS# | 
CECLARE O©1 DUMMY REMAPS IPB ELTCI440)> 
O2 FILLER B1TC1192)> 
O02 IPBeHARDWARE CHARCI)> © 
02 IPBe-ARCHITECTURE -NAME CHARC10)>. 
O02 TPB.COMPILER.LEVEL BITCH)» ~ 
O2 IPB.MCP.LEVEL BITCEd> - 
M2 IPH-GISMO-LEVEL BITCE > 
02 IPBeARCHITECTURE. ATTRIBUTES BITC 80)» 
92 eee BIT(55)> 


— TPBe HARDWARE will contain either an "S™ or an "Mt, depending upon 


whether the interpreter was generated for an Smemory or an 
M-memory processor. Alt B18060"'s are considered to be M=memory 
processors. IP@-ARCHITECTURE.NAME nitl contzir the generic name 
of the compiler» such as COS8O0L or FORTRAN* IPB.COMPILER.~LEVEL 
wilt be a number which wilt corresporc to cae. release level of 
the scftwaree as described below. iUFB-MCP.LEVEL> IPB.GISMO-LEVEL 
and IPB-ARCHITECTURE.ATTRIBUTES are parts of the tnterpreter 
verification feature cf the MCP. i na | 


The 61000 MCP includes facilities to recognize the hardware 


configquation it is executing upon anc select the corresponding 


interpreter from the disk directcry» Att frrograms which are. 
compiled for execution on a B1000 witl have ar interpreter “TYPE™ | 


requested the rfrogram paremeter block of the code file Cdescribed 


in a tater section)» or the specific rame of the interpreter ta 


de usede As explained in a later sections the program parameter 
block contains space for three names tc be associated with an 
interpreters For discussion purposes here» the three names will 


be referred to as the “PACK” names the "“FAMILY™ name and the 
"OFF SPRING" Name e | | e a : | 


ae 
: 
F 
2 
an 
: 
: 
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The 51000 compilers generate the tast two names of the 
intercreter orly. The femily nawe gererated always corresponds 
to the language the program is written ins such as *COBOL” or 
“"“FORTFAN™. The offspring name 1s always one of the reserved 


words “*INTERP™s» "DEBUG" or “TRACE”™. At BOJ» the MCP modifies the 


offspring name by concatenating one numeric character denoting 
the compiler tevel and either the chéracter "M™ or "S" depending 
upon whether the machine 1s equirpec with an S-memory or an 
M-memcry processor. | on 


The level number concatenated is containec in the program 
parameter block as “PROGeCOMPILER.-LEVEL™. Every time the 
compilers are changed in such a marrer that the interpreter must 
also te changed» the Level number gqererated by the compiler is 


incremented. The interpreters are then modified accordingly and 


released to the fielec under anew nasew The new name wiilt be the 
same as the cld ones» except for the tevel number contained in the 
nmamee For a COBOL program whicr is heitrg executed on 4a 


 Bl720-series machine and inad beer compileac by the 4.1 COBOL 


compiter» the MCP will generate “"COBOL"/*"INTERPIM"™ as the 


interpreter rame toa he used for the execution. tt should be 
noted that this feature was first included in the 4.1 #£=software 
releases Level numbers were not includec itn the program 


paragweter block prior to the 4.1 release. 


Once the interpreter name is generated» the disk directory is 
searched for the interpreter. Upon finding the interpreters the 
MCP will bring it into S~memorys if it is not already theres and 
construct an entry an the “INTERPRETER~CICTIONARY™. Alt 
interpreters are retentrant on the 861000-~ Att of this is 
described in aqreater detail in the pézragraph which follow. Each 
entry tin the interoreter dictionary has the following format. 


DEFINE IDeDECLARATION AS#DECLARE | 
01 CUMMY REMAPS INTERPRETER.~DICTIONARY> 


02 ID.SEG.DIC SY -DSCR> 
02 IDSENTRY.IN*USE BOOLEAN» 
02 IDeRSDNTUSERCOUNT BITC7)>» 
02 IDsTOTALsUSERCOUNT  BITC7)>» 
O02 IDsMIN.M.SIZE |  BITC4)> 
02 IDsMAXeM.SIZE BITC4) >» 
02 ID-FARTIAL.BIT | - BOOLEAN» 
O02 ID.-BLOCK.COUNT BITC4)> 
G2 FILLER BIiTC19)>» 
02 ID.M.PRESENCE-BIT BOOLEAN» | 
O02 ID.M.ADDOR —— BITC12)> 
02 ID.1TO0PM :  BITC4)> 
O02 IDeMEDIA - BITC2)> 
O2 IDLCCK | BOOLEAN» 
O02 FILLER © ee BIT €13)- 


02 1D.TYPE : BITC4) > 


SREREEI 
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02 IDsADDRESS : - BITC36)». 
03 FILLER BITC12), 
03 IC.CORE | BITC24)>» 
02 ID.LENGTH BITC 249543 


There 1s ane entry iain the interpreter dictionary for each 
interpreter presently in usee The I/C driver is always the first 
interpreter entered in the dictionary» the Micro MCP is_~ the 
secerd entry and SDL is always the third entry in the dictionary. 
On the B8100C» it is passibdble to segment interpreters. 
Consequently» a code segment dicticrary 31s constructed for each 
interpreter as it is Erought into mesory.e The system descriptor» 
the first item in the interpreter dictionary» is a pointer to the 
intercreter's code segment dictiorgrye Irterpreters may be 
segmerted»s exactly as programs are. The same routines in the MCP 
are used for handling program segqmerts and interpreter segments. 


A certain amount of information abcut each orogram currently 


being executed is maintained in memcery by the MCP. The field in 
which this information is wmaintaired is known as the Run 
structure Nucleus of the prograw. It is abbreviated as 


RSeNUCLELS.~ In the RS-NUCLEUS*» there is an index inte the 
interpreter dictionary. Alt programs being executed at any given. 
time which are using the sawe interpreter witt have the same 
index in the field in their resnective nucleus. In this manner» 
interpreter retentrancy is acconplisted. | 


The remaining field in the interpreter dictionary entry will not 


be described in detatii at this pointe For a more detaited 
description of interpreter management» the reader is referred to 

the section of this document which deals with M-memory 
management. It should be sufficient at this point to say that 
all interpreter segmerts except the first are treated as ordinary 
code and are considered overlayable. The first segment of each 


interpreter is not treated as ccde and is not overlayable»r 
howevere 


The I/O drivers which is considerec an irterpreters is an 


exception to the above statements. 
COLE FILE 2° PROGRAM PARAMETER BLOCKS AND FILE PARAMETER BLOCKS 


The code fite of every program must contain two types of records 
to allow the MCP to manage the execution of that orogram: the 


"File Parameter Block” CFP3)»- and the "Program Parameter Block" 


CPPB8). There is one FPB for each file declared ina oe plus 
one ertry for a trace file. 7 
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The first 288C bits Ctwo disk segments) of every code file is the 
"Program Parameter Block™ (PP3) whose format is rigidty defined 
by the MCP. Every compiler generates a PP8 cf the same format. 
It prcvides» for the MCP» all the vital statistics of the program 
including: The program*s names the name cf the interpreter to 


be used during executions the relative addresses of the FPSB'*s>» 


IPB» code segment dictionary and data segment dictionarys memory 
requirements for the program's executions and tracing 
information. | 


At rur time a working copy of the PP@ is written into a temporary 


or permanent Log Cas dictated by the system options). The first 


two segments of this four segment entry are an exact copy of the 
PPB from the code file. Another secwent is generated by the MCP 
and cocuments certain features of that particular execution. A 
final segment is reserved for an abrermal termiration message. 


If the code file is an interpreter ccde file» it contains an 
additional secqment calted the “Intercreter Parameter Block”. [t 
contains information concerning the software compatibility of the 
interpreter. A field in a progras's PPB specifies under which 
intercreter it witl rune When the program is scheduled for 
executions the IPB of the interpreter named in the PPB is checked 
to insure that the interpreter is comapatible with both the code 
file and the system software. The MCP informs the system 
operator via a SPQ message if the interpreter cannot rune Refer 
to the appropriate MCP listing for a crogrammatic description. 


The “File Parameter Block" CFPB) is a 1440-bit record created by 


the compiler from the user's file attribute declarations. Its 


format is rigidity defined by the MCP» and it contains the vital 
statistics which allow the MCP to manage the file's usage. When 
a job is scheduled for executions a working coovy of the FPB is 
written into a permanent or temnorary log Cdepending on. system 
options). In addition to recording the file's attributesr the 
MCP decuments the use of the file during that job*s execution. 
It records such information as the number of times the file was 


opened and clased»s the total amount of time the file was opens 
the number of records reads the nuaber of I/O errors, and the 


file typés Refer to the appropriate MCP Listing for a 
programmatic description. | | | 


EILE INEQRMATION BLocKs 


As each file is opened by the user programe a structure known as. 
a File Informatior Block CFI3) is created in memory by the MCP. 
The FIB contains all information necessary for the MCP to perform 
normals» requested» 1/0 operations on the files | Much of the 


inforration in the FI8 is taker directly from the FPB. Other 
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information in the structure is inserted by the MCP» based upon 
the characteristics of the peripheral device assigned to the 
file. Device assignment is discussed in the section of this 
specification which cescribes the OQnen Communicate. | 


FIB"s vary in sizer depending upon the type of device assigned to 
the file. Due to the ameurt cf information which must be 


maintained» a disk file FI3 is such larger than that of a card 
punch files for example. | JH 


I/O cescriptors and buffer memory areas are atltocated and 
initialized by the MCP at the same time. ‘There witt therefore he 
one memory Link only» for each file that is active ina program. 
Buffer areas and descriptors are not normally shared between 
files» though the Data Managemert subsystem» the Data 
Commurications subsystem, the Relétive file implementation and 


the Indexed file implemenation offer some exceptions to this 


A cogsplete structural description of the FI8 Wili not he 
presented herein» due primarily to the length of the structure. 


Also» the FIB is of interest tc the various portions of the 
Operating System only. The Drogréemmatic description of the 
Structure is readily available ir the MCP Listing. Sizes of 


FIB's for the different peripheral dévices are presented in the 
following table. 2 as 


Fite Assigned to: Size in Bits 


Reader~Sorter 142 
Printer | | 724 
Remote Device | 557 
Tape | 7124 
Cisk 976 
Queue - 385 
Atl Other Devices 4 | 612 


RUN SIRUCTURE 


The structure in mencry that represents the state of any process 
as the run structure. Each process has a unique run =  structuree 
When a job is initialized before execution the MCP creates the 
run structure from an analysis of the Program's code fites and 
adds certain information it will need for management of the 
execution. ALL run Structures are lirked together by priority. 
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A run structure éonsists of a prograa'’s data or address space» 
the KCP"s manacerial space called the run structure nucteus» and 
the file and data segment dictionaries. The program's address 
spacer resicing between its base arc Limit registers» is that 
area cf memory that may ke accessec and -fantpnulated by the 
program itsetf. A program's base register is a memory address 
that warks the Lower bound of its adcressable space. The Limit 
register snecifies the upperbound. A program may not access 
memcry that is outside its own base to limit area» though this 
tenet is enforced by the interpreters and not the MCP. 


A program's address space may contain both resident = and 
overlayable data. The resident data area cortains those’ fields 
which will te present in memory ttroughout the duration of the 
execution. The overlayable data spzce contains segmented data 
: which may be brought into or out of Pen oy as needed. 


BUN S1QUCIURE CLEUS © 


The Run Structure Nucleus is an area structured and maintained by 
the MCP and cortains the essential irfcrmation about the program. 
It resides in memory directly akcve the be al s Limit register 
and 18S accessibte by the WMCP and the pregrae: S interpreter. | Tt 
contains such information as? | 


| 
| 7 
7 3 * Pointers to 


: BASE AND LIMIT 

i SEGMENT DICTIONARIES CCODE AND DATA) 
| _ FILE DICTIONARY | 

: INTERPRETER DICTIONARY ENTRY 

NEXT RUN STRUCTURE (BY PRICRITY) 
CODE FILE OW DISK 

QISK LOCATION OF RUN STRUCTURE IF "ROLLED OUT” 
PROGRAM*s LOG ENTRY 

VIRTUAL CATA SPACE ON DISK _ 
NEXT INSTRUCTION TO BE EXECUTED © 

DMS POINTERS | 


* Structures necessary for communication pepncge the ‘program and 
| the MCP | 

Fields to reflect the state of the Semae rane 

* Fields for program switches 


A programmatic description say be obtzined from the MCP Listings 
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«DATA AND EILE GILTLONARTES 


The data segment dictionary resices at the end of the Run 


Structure Nucleus ano is pointed to ty a field in. the  nucteus. 


If there is no segmented data and the user has not requested that 
his resident data area he initializec» ther the pointer wittl be 
nulls» and there will be no dictionary. | 


Fach entry ir the dictionary is an 80-bit system descriptor 


pointing to one data seqment. 


The lest element of a run structure is the file dictionary. 


There is one @80~bit descriptor for each cectared file plus ane 
additional descriptor for a trace fiie Cused for tracing). t#hite 
a file is open» its dictionary ertry points to the file"s FIB in 
memory. If a file has never been openeds its entry is null. Tf 
a file has heen temporarily closed Ci.ew» “CLOSE ROLLOUT")» its 
dicticnary entry points to its FI& which has been written to 
disk. After a permanent closes» the file*s dictionary entry wilt 
again te rull. | | 


RETENIRANT PROCESSING AND CODE SEGMENT DICTIONARIES 


The B1iG0C MCP allows rerentrant processings the ability of two or. 
more proacesses to use the same cade segrent dictionary and» 
therelLy»s the same codee The code segment(Cs) and code segment 
Gicticnary reside outside a program's run structures anda field 
in the run structure nucleus pcecirts to its code segment 
dicticnarye A structure called the segment dictionary container 
contains the information necessary to . govern the use of a 
particular ccoe segment dictionary. Wher a job is being 
initiated for executions the MCP determines whether or not’ the. 


code segment cictionary desired ty tte job is already in use. If 


it is» that dictionary wilt be used. The segment dictionary 
container reflects» amonc other thirgs» the number of processes 
using the dictionary it describes. If there is more than one 
users the segment dictionary container will remain in memory 


until all users have completed executicn. 
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IHE 1/0 SUBSYSIEM 
This section of the specifications is a description of: 


1. 1/0 Descriptors 
2@o GISMO Coeration 
7 1. Channel Table 
2e GISMO/Hardware Interface 
Be CA/RE Cycles 
2e¢ Processor I/0 Instructions 
3e Service Reauest 
4. Status Counts 
- Se Data Transfers 
| $e 1/0 Chaining 
[ | 4. Disk I/0 Chaining 
‘ Se Disk I/O Qverlapped Seek 
6- Tape 1/0 Chaining 
2. Monitoring of Peripheral Status 
| 4d. 1/0 Assignment Table , 
| éo Unit Mnemonics | 
| 3e Test and Wait 1/0 ieerevare 
4. STATUS Procedure 
Se Disk Identification ~ Pack Labels 
6-2 Pack Information Table | 
fe Tape Labelling» Sone emer ten and Purging 
| $2 Tape PE/NRZ Exchanges | 
i 4. File Structures 
| | 1. Conventional Files 
1. File Attributes _ 
2e File Naming Conventions. 
. 3. Logical Disk Files | 
: 4. Physical Disk Files | 
i 1. Disk Space Allocation 
ee | | 2e File Access and Identification 
| 
| 


30 Disk File Identification 
| 4. Disk File Header 
ek | | 5. Multi~Pack Files 
| | . 1. Base Packs ~ 
: | 2e Continuation Packs - 
3e MultitPack File Information Table 
4. Multi-Pack File General Restrictions 
6. Printer Files 
| 1. Logical/Physical 1/0 Relationship 
2e Logical Page Ieplementation 
7- Printer and Punch Backup Capabilities 
le Backup File Blocking Factors 
2e Backup File Cortrel Information 
| 3- Backup File Reccrd Format 
20 Relative Files 4 = | 7 
| 1. Direct Files 
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2» Data Structure 
_ Se Disk Initialization 
Gs File Parameter 8tocks 
. Se Disk Header ss | 
be File Information Blocks. 
? fe Communicate Operators 
4- Indexed Sequential Files 
le Direct Files 
Ze Index files 
3e Cluster Files 
4. OData File Structure 
2- Index File Structure 
6e Memory Structures 
1. FIB Dictionaries : 
@e User Specific Infcrmation CUSTI) 
$e File Global Infcrmation (GLOBAL S) 
4- Structure Descrirtor 7 
 3e Disk File Header Extension 
fe Available Space Allecation 
8. Index File Table splitting 
Je Current Record Pointer | 
10. Current Maintenance 
11. Buffer Management 
i2. Buffer Descriptor | 
At. Concurrent Update Orerations 
se The I/C Error Procedures | 


There is some cverlar between the infcrmation contained in this 


Secticn of the specification and that contained in the Demand 


Management section of the documert. The Demand Management 
section was originally intended to cover the management of the 
pertpheral after it had been assignec to a user as a file; the 
T/G ‘Subsytem section was intended to cover the management of the 
aqevice up to that time. This division is not always possibie»s 
Particularly in the case of disk devices. The reader may have to 
refer to both sections of the documert to find the answer to a 
Specific question. _ 


140 DESCRIPIORS 


Normal state programs reguest I/0 functions in a symbolic fashion 
 f€eeges» Write z Record). The MCP must transform these expressions 


into explicit I/0 operators cattled I/0 descriptors. An 1/Q. 
descriptor allows the MCP to ccamunicate directly with a 
peripheral device via the soft Ist routines of GISMQO. GISMO 


manages the execution of these operators by the 17/0 subsystem. 
Each 1/0 descriptor provides such irformation as the type of I/0 


operatton requested» source or destination femory addressess the 


device which is ta execute the cperators>s and space for result. 


information used when controi is Passed back to the MCP. Certain 


other fields vary with the type cf descriptor and contain 


rar 
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information peculiar to its specific function. 


Any number of I/0 saseRineeds may be Linked together to form a 
Single “chair™ and "dispatched" ir one MCP operation. to lessen 
the MCP"s interaction WIth the 1/70 subsystem. | | 


The transformation of tLogical I/C requests to physicat Iva 
descriptor manipulation is discussed in the Demand Maragement 
section of this specification. The ciscussicn below is intended 
to describe the operations performed upon the descriptor after it 
has been transformed. A orogrammatic description of an I/9 
descriptor ts given below. This particular descriptor is “EVE NGat 
of ane which noe te constructed for ¢é disk file. 


DEFINE Id. DESC «DECLARATION AS aX 


DECLARE O01 OUMMY  REMAPS 10.DESC 
» 02 I0.RESULT WORD 
» 03 IN.COMPLETE | BIT (1) 
» O03 IO.EXCEPTION ~ -» BIT (1) 
, G2 IO.PACK.NOTeREADY. PIT €1) 
» 03 ITOs.DATAJECCJERROR: FIT (1) 
, 03 FILLER 4 BIT (1) 
p C3 [OmaMEM.PARITYsERROR 3IT (1) 
- O3 LO.WRITE.LOCKCUT BIT (1) 
, C2 FILLER BIT €2) | 
? G3 IO.~ADDRESS.PARITY.ERROR BIT (1) 
» 03 IO.SECTOR.ACCRESS.ERROR BIT (1) 
» 03 LO.SEEK.TIMECUT BIT (1) 
» C3 FILLER BIT (3) 
’ C2 I0.TRANSMISSICN.~ PARTTY.ERROR BIT (1) 
, C3 IG0-RESULT~BI1.17 © BIT (1) 
, 02 I[0.PORT.RS a PIT (3) 
, C3 IO.CHANNEL.RS . BIT (4) 
» 02 IN.Link — ADDRESS 
» G2 10.0P a WORD 
, 03 I[0.CP.0P RIT (3) 
> C3 f0.NP.M - BIT (1) 
> 03 10.0P.4 BIT C1). 
» 03 «#%[0.0P.V BIT 1) 
> 03 #TO.0P.€ ~ «BIT (1) 
» 03 [oO.CP.D | | BIT (1) 
, 023 =%[O0.0P.NNN. BIT €3)_ 
» 03 FILLER © | BIT (5) 
» OZ I0.0P.P | RIT C1) 
» 03 FILLER © : BIT (3) 
, 03 I0.0P.UNIT BIT C4) 
7 02 I0.8EGIN ADDRESS. 
» G2 IO0.END | | ADDRESS 
» 02 I0.MeEVENTS | BIT €8) 
Fd 


—=03 «TOeMsEVENTS.ICC BIT €1) 
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» O03 IJO-MeEVENTS.«STOC BIT (1) 

| - 03 FILLER BIT CL) 

; 03 IO-M~EVENTS.~INTY.M BIT (1) 

| > Q3 IO.M-EVENTS-S.INT-SENT BIT (1) 

| » 03 FILLER a «BIT C1), 

2 - 03 LO sMeEVENTS«INT“S Bit €1) 

» O02 I0.MCP.I0 - BIT (16) 

: » 02 I0.FI8 7 ADDRESS 

| » O02 I0.FIS.LINK = ADDRESS 

» 02 I0.BACK.LINK ADDRESS 

» 02 I0.PORT.CHAA | BIT (7) 

- 03 IQ.PORT BIT €3) 

| » 03 IOQeCHANNEL BIT (4) | 

, O02 IQD.BEEN»THRUEFROR | BIT (14> 


-_ - GISMO = JHE 120 DRIVER 


With the exception of the MulticLine Controt used on Oata 
Commurications conftgurations» on the 821000 hardware the i/0 
contrcls have no direct connectior witht main memorye AtL data 
transfers between the controeis ard tlemory must go through the 
processore C150 is a set of micro~coded routines whose primary 
function is to interface between the MCPs and the actual 
hardware. This allows the MCPs to view the I/0 subsystem as an 
I/O frocessor. The MCP can initiate I/G Descriptors ang GISMO 
will handle initiation of the cortrol>» data transfer and 
tergiration. The MCPs can cueue several descriptors (for 
execution by a controls» by property setting the tink fields in 
the descriptors» and GISMO with initiate each one in turn. 


: | User programs make requests to the Picro MCP» and sometimes the 
4 Micre MCP must ask that the request Le handled by the SeMCP» but 
nf in either cése» the MCP will pass the request to GISMO who in 
: turn will pass it on to the I/0 control. | 


the. 1/0 subsystem allows fifteen ccntrols cr channels to be 

 ednnected to any machine. After GISMON initiates a control» it 
doesé rot wait for completion of the cperation but returns control 
tec its caller. Consequently» one» ard possibly more operations 
may be in process on the machine at any given time. At any given 
moments howevers when SISMO is executing it May ak address one 
iON ECE Es | : 


The primary ccemmunication between the MCPs avid: GISMO is through 


the I/0 descriptors. The S-¥CP will initiate I/0 operations 
using the DISPATCH S“operator and the MeMCP contains micro~code 
to perform 4 simiiar function. This S“operator requires two 


parameters» the port and channel of the device being addressed 
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and tne memory address of the descriptor. The I/0 decsriptor 


ccntains alt of the information needed ty GISMO fcr the 
operation. | , | | 


An 140 descrirtor is usually Located by its “Reference Address» 
the memory address of the result descriptor field of the I/0 
descriptore The result descriptor tield is often referred to as 
the “KS field"» or Result Status field. ALL of the descriptors 
associated with a given control witt be linked together in 
memoryr ty setting IO0-LINK to the mencry address of the FS field 
of the next cescriptor. The descriptors are also linked in the 
reverse direction» using the [0.BACK-LINK field» to facilitate 
adding and deleting descriptors. A Link field may not be zeros 
but a descriptor may te linked to itself. 


: The Reference Address points to the fS field. Each RS field is 
nn twenty"four Fits in tength.e The bits in the RS field have 
: different meanings at different times» GISM0O is most concerned 
with the setting of the bits when the 1/0 is initiated. The MCPs 
are #ore concerned with the setting cf the bits when the I/0 is 
complete. when the descriptor is ready for initiations the RS 
fielc is formatted as shown in the fctlowing diagram. This field 
is usually referred to as the result status field when the 
descriptor is ready for execution or is. in process and as a 
result descriptor field when the I/C operation is complete. 


Bits O-1 - RS Status Sits 


“ | 00 - Ready to te Executed 
a7 | | 01 - I/0 Currently in Process 

10 - I/0 Conplete with no Exception 
11 7 I/0 Comntete with Excertion 


Hits 2-11 - Cismo Toggles” 
ae 7 MCPs may not alter any ‘bits: in this field if 
| | es _ RS Status = Me oS aa oe 
i Bits 12-14 - Port to which this ‘iso is dipected: (Not used) 
| Bit 15 - Interrupt requested on I/0 Completion. 

Bit 16 - High-Priority interrupt requested on I/0 


Completion. 


Hits 17719 Port to which interrupts are te be sent upon 


1/0 Comptetion i Processor Zerode 


Bits 20-23 - Channet on which I/C is to be attncaits | 
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The leftmost bit of an RS field Ss always set when ihe. operation 
ts conplete. Consequently» storing ~€ result descriptor tocks the 
descriptor to GIsMo. The MCP may Icck a descriptor as wetl» if 


the status field is not O1. Gismo will only initiate "ready" 
'descriptorse those whose status bits are eaual to 00. When the 
operation is initiated» GISM0O sets the status bits to 91. The 


| GISMO toggles area is used by GISMO when ar I/0 is in process to 
| store infor@gation which it needs concerning the operation. 


CHANNEL TABLE 


‘Another structure associated with peripheral management is the 
channel table. There is one channel table for each port and each 
elemert of the table describes one ctannel of that port. whike 
| | G¥Svc uses the I/0 descriptor to ccamunicate directly with the 
! I/Q subsystem» the channel table is a structure for passing 
information between the MCP and GISMO.. The channel table 
reflects the status of a particular channel. Certain information 
is passed to GISMO during a “dispatch” operation and is used hy 


seft 1/0 in managing the execution cf that operation. Certain 
fielcs are updated before GISM0O péesses controt back to the MCP 
whicn direct the course of actior the MCP will take. A 


progrémmatic description is given below: 


DEFINE CHANNEL.TASLE-CECLARATION AS & 2 
DECLARE O01 DUMMY REMAPS CHANNEL.TABLE 2 


’ G2 CHANNEL BUSY BOOLEAN 2 
: » O02 CHANNEL.~PENDING | BOOLEAN % 
. » O2 CHANNEL EXCEPTION © BOOLEAN 2% | 
: » Q2 CHANNEL PAUSE BOOLEAN 2 O = TAPE» DISK» CAS 
: s 02 CHANNEL OVERRIDE BOOLEAN 2 . 
e G2 CHANNEL -EXCHANGE BOOLEAN % 
» 02 CHANNEL.OLO.MODE BOOLEAN % 
: O02 CHANNEL.INTEGRITY BOOLEAN 2% 
» G2 CHANNEL -NOHALT BOOLEAN 2 
» O02 FILLER | BIT €3) 2 
» 02 CHANNEL.TYPE BIT €4) 2 DEVICE TYPE FOR DUMP 
Z | TYPE = 4 = SERIAL DEVICE 
& TYPE = 1 = DISK 
Z TYPE = 2 = TAPE | 
% : | | TYPE = 3 = CASSETTE © | 
» G2 CHANNEL.LAST BOOLEAN 2 |  DELIMITS CHAN TABLE 
e 02 CHANNEL-SEXCHANGE.PC BIT (7) 2 | 
, 03 CHANNELSEXCHANGE.P BIT €3) % 
P O03 CHANNEL-~EXCHANGE.C BIT (4) 2% 
»  O2 CHANNEL-REF.ADDR | ADDRESS 2 
> HF & . =o 7 


ae: the CHANNEL « TABLES ‘BUSY 1s set and reset. Bye GISMO only. it is 
set when oe centrot is busye PENDING is also set and reset by 


ee WORETSAE Ee sali oa eT ee eR 
s EAL SNES 
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GISMO. It is aged. on tape and disk devices only and it tells 


GISMG to continue Linking through the head of the queue. 
EXCEPTION is used on all devices excert tape and diske It causes 
GISMO to inhitit dispatch operations cn the channet until a prior 
exception concition has been handted hy the MCP. 


PAUSE is also known as the TIMER bit. It is set by the MCP and 
tt never chancese It causes GISMNM to issue a dispatch to the 
channel at each 100 millisecond tinrer irterval and is used to 
implegent TEST.-AND.WAIT operations or tape ard disk controls. 
This is discussed in more detait later. | 


The CVERRIOE bit is used on atl devices and causes GISMO to reset 
BUSY» PENDING and EXCEPTION when arew operation is dispatched. 
It is set by the MCPs and reset by GISMO. Essentially» it causes 
GISMC to override an existing operaticn with a rew operation. 


The EXCHANGE bit ts set by the MCP arc it nmever changese. It is 
used on tape and disk controls only. and it means that the 
information ir EXCHANGE.PC is valic» that there is another 
control connected to this contrct Ly a hardware exchange. The 
OLDs»*CDE bit» also known as the PAUSE bit» is also set by the MCP 
and rever changes» It is set for Single~Line Controls and for 
Disk Cartridge Control One. It causes GISMQ to pause for 100 
milliseconds when a locked descriftecr or a Pause 1/0 descriptor 


as erceuntered. If this bit is not set» GISMC will stop in this 


circuastance on these controls. 


The INTEGRITY ort is set by the MCP when the channel table entry 
1s Inttialized. It 1s alsa used ay ne MCP to ston GISMO from 
Linking or the channel. | 


The TYPE fietd is used only by the Dump Analyzer program. It is 


necessary because the analyzer may have ro other means of 


detergining this information. The REF.ADDR field contains the 


address of the descrirtor that is in process. cn this channel. Ct 
is corsidered the head of the queue Ly GISMO. 


GISMO/HARDNARE INIERE ACE 


a 2 ame «a « Ce AER ae ee ae oe 


The I/0 descriptor contains most of the irfcrmation GISMO needs 


tc accoaplish an 1/0 operation. In the actuat hardware 


interface» the OP» BEGIN» END» DISK-ADDRESS and ACTUAL.END fields 

are used. The ACTUAL.~END field is txwenty"four bits in tength and 
ammediately preceeds the RS field in each descriptor. It is not. 

shown in the preceding 1/0 descriptor diagrame The field 1s used © 
by GISMO while the operatian 1s ir EEeeess. to store eRe menory 


fe TIES gs gaprimip renee 


3-8. 


BURROLGHS CORPORATION = so gaweaNY: CONFIDENTIAL 
COMPLIER SYSTEMS GROUP ~ | 000 MEP TI 
SANTA BARBARA PLANT ) | . PoSe 2212 5462 CE) 


address of the data that ts to be transferred to or from the 
memory buffer. When the oneratton 15s complete» ACTUAL-END will — 
contain the address of the next hit thet date would have been 


transferred to or from. 


Each controt is able to buffer» oar store» acertain amount of 
data to be transferred. The amcunt varies among the devices. 
For scme devices» such as the card reader anc tine printers it is 
a full record. For others» the size of the buffer may vary and 
each contol may contain a portion cf the datas Disk controls» 
for example» are equipped with a certain number of (U80-byte 
hardwzre buffers. | The amount of cata that may be contained in 
the cantrols and the procedures that GISMO0 must follow in the 
execution. of an cperattion are fixed when ‘the control ais desigqned 
and dc not change afterward. : 


nn ab ine am ae at ae 


The hardware in the processor thst is used by GISMO is the 


Command Registers the Cata Register and the Service Request 
level. The Command Register is usec to send information to a 
contrcil»s the Data Register to receive frow the control and the 


Service Request Level indicates that a control needs attention 
from CiSmc. | | 


Most transactions with the | control consist oft a 
Command~Activate/ResponseComplete (CA/ROI cycle. Data or 
commard information is sent out to a centrol with a CA. Controt 


inforgation or data is returned with a RC. 


PROCESSOR IZ0 INSIRUCTIONS 


The processor instructions whch GISMO uses to accomptish an 
operation are: | 


TEST STATUS 
 €ISMO requests and the contrat returns its current status 


count and the device I). GISMC uses this information to 
cecide what to de next. , 7 


TEST & CLEAR 


This operation clears the cortrcl. 


TEST SERVICE REQUEST 


€ISMO recuests» and the processor returnse a mask of alt 


4-9 


—GURROLGHS CORPORATION COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP 7 B1000 MCP If 
SANTA BARBARA PLANT - PeSe 2212 5462 CE) 


chanrels that are currently recuesting service. 


TERMINATE DATA 


This operator is used to terminate data transfer when the 
gedia» disk and tape for example» has no fixed record size» 


TRANSFER OUT A 
Moves ore or tho bytes of data from memory to the control 
for output to the devicee Cate is sent at CA time> the 
controt returns its status at RC time. | 


TRANSFER OUT B 


Moves three hytes of data from memory to the control for 
cutput tc the device. | 


TRANSFER IN 


woves one» two cr three bytes cf data from the control to 

fain memory on input operaticrse. The data is sent at RC 
time. hhen one or two OSytes 1s transferred» the control 
elsc sencs its status. | a 


SERVICE REQUEST 


The Service Request ltevel is a togcle in the processor which is 
settable by any control. It is OR-ec into the "Any Interruct” 
toggle. Each Interpreter» prior to executing an S~oerators wilt 
test the Any Interrupt toggle and» if it is set» transfer control 
to GISMO instead. GISMO wilt deterwine what caused the toggie to 
be set. In this case» it will disccver. that Service Request 15 
raisece 7 | 


it wali then do a TEST SERVICE REQUEST CA/RC cycle. The RC will 


returr amask of allt controls that are currently requesting 


service.  GISMO witt setect the highest chanrel from this mask 
and begin handling that control. Corrols are usuatly in status 
count 11 or 18 when they raise Service Recuest. This status 


andicates that the control is ready te send a Reference Address 


to Gitmo. GISMG accepts the Reference Address and uses it to 
iecate 1/0 descriptor in memory. | | 


 GISMC will then do a TEST STATUS CA/RC cycle to detemine what 
service the control is reauestirge Once the requested service 
has been performed» and the control no torger is requesting 
services GISMO will again perforw a@ TEST SERVICE REQUEST CA/RC 


cycle. It will continue handling Service Requests from various 


controls until the TEST SERVICE REQUEST returrs ail zeros. GISMO 
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then returns control to the Interpreter that was interrupted. 


2TATUS COUNTS 


The Status Count returned by a contrcl is the primary means iin 
which GISMO determines what is to be done next in an I/O 


operation. Crerations may consist cf sending the Op code. and 

file address» sending the Refererce Address> receiving the 

Reference Address» sending or receiving data and receiving the 

result. Various controls perfersr these stens in cif ferent 
orders. f | 


All controls begin in Status Count 1 and return to Status Count 1 
after Status Count 23. Each Status value has a particular 
meaninge some counts always aopear ir series together. Ail 
controls begin an operation by ¢cing through Status Counts 1 
through 6. A simplified table of the altowable Status Count 
trarsitions is shown in the table belawe. 


To send each of the twenty-four bit fietds OP> DISK»~ADDRESS and 
Reference Address» three TRANSFER OLT operations are useds each 
CA/RC sending one byte. For egch TRANSFER OUT» the Status 
Counter advances by one. Similarly» to receive either the Result 
Descriptor or the Reference Address» three TRANSFER IN operations 
are used» each CA/RC receiving one byte. 


BURROUGHS CORPORATION 
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Status Count 


4e 5» 6 


17 


18s 19» 20 


— 21e 225 23 


Table Xex - 
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Meaning 


Controt Not Present 

Clescea (Initiat) state | 

Ready to Receive OP>, Bytes 1> sid 3 | 

Ready to Receive OISh ADDRESS» Bytes 1» 25 3 
Ready to Receive Reference eeeeree Py tes Ll» 2» 3 
Busy (Operation ir prccess)s From 10» Controts 
usuaily go to Status 11 or 18 and raise 

[service Request. | | - | 

Ready fo: Sena Refererce Ao dees Bytes 1s 2» 3. 
eeads to Receive Cate Coutput) on 


Ready to Send Data Cirput) 


End of Hardware Buffer - eady to Send or Receive 
Last Byte. More Buffers Remair. : 
End of Hardware Buffer and fast Buffer. 


Ready to Send Refererce Address» Bytes Il» 2» 3. 
Implies that 2 Result Descriptor is to Fellow. 


Ready to Send Result Descriptors Bytes 1» Cr 3. 


Typical Control Status Counts and their Meaning 
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DATA JRANSEERS 


GISMC transfers data to and from the control in one or more 


aiterationss each iteration will invetve only one control buffer. 
For scme devicese there ts onty one buffer ard this buffer witt 


always contair the full physical reccrde GISMO will onty perforne 
data transfer once oer I/0 operation fcr these controls. - Other 


contrcls have physical records of undefined lengths for these 


contrcls» there are usually multiple buffers of fixed Length in 
the ccntrol and each iteration of GISMG will es or empty one “et 
these buf ferse 


whenever Service Request is raised ard GISMO is invoked» the 
requesting control will first send the refererce address. GISMO 


wilt then test the control's statuse If the control is in Status 


14 or 15» GISMO will begin data transfer. For each operations 
data transfer will continue until either the control's Duffer is 
empty or the END address of the [/C descriptor is reached. In 


the first case» the control witl have gone tec Status 7 after the 


fast cata character(s). GI5M0 witl test its status» see that it 
is tn Status 7 and send it the Reference Address» thus completing 
the iteration. In the latter case» on most controts» GISMO wilt 
send it a TERMINATE command. Some coertrols require data transfer 
to ccntinue until the end of the control's buffer. On incuts 
GiISMO will accept the remaining data from these controtis but will 
not store it in =memory. Qn output GISMO will send btanks to 
these controls. | | | 


Data 15 always transferred to a control in one» two or three byte 
porticnse Mest “Serial” devices» such as printers and card 
devices»s use one byte transfers. This data transfer is perfcrmed 


from aiétoop within GYSMO which consists of a CA/RC cycler 


transferring one data byte» until the control*s buffer is full or 
the END address is reached. A buffer full condition is detected 
by the cortrol serdine or receivirg the last data byte in Status 
Count 16 or 17. | 


Many disk anc tape controls transter data two bytes per CA/RC. 
Disk input and output is always terminated by GISMO when the END 


address is reached» possibly in the last of multiple disk 


secters. When the record length is zgn odd nugber» GISMO witl 
norgalize the last byte as required. On output operations» the 


controt will pad the remainder of the last buffer Cand hence 
eoctars whith zeros. : | | 3 


Vane outputs. posstbly tn the Last of multiple bufferse is also 
terairated by open when the END address” is. geo ae ihen the 
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physical record size is an odd number of characters» GISMOD will 
normalize the last byte for the tast CA/RC cycles. It will send a 
TERMINATE coemand> followed by <€. special command which will 
indicete “odd character count™ to tetl the control that the tast 
data transfer consisted of cne byte crly» Tape input operations 
will terminate either when the END acdress is reached or when the 
end cf the physical record is encountered» which may be in the 


last cf multiple buffers. If the erc of the ohysical reccrd 


cccurs and the length of the reccrd is an odd number of 
characters» the control will set a tlag in the RC portion of the 


last CA/RC cycles. GISMO will then norwatize the Last byte of the 
record. | 


ALl disk pack controls» the SN head-per-track control and att 
phaseencoded tape controls use three byte data transfers. [In 
this case only» ar exception is made te the general rule that att 
transactions involve one CA and cne RC. On these controls» one 
CA may be followed by one or more RCs. This ts accomplished = as 
follows. | 


Prior to entering the transfer loop» on inputs GISMO@ will use a 


special CA/RC cycle to ask the cortrcl how mary butes it has to 
senda It wilt then initiate the transfer toop with a fa and 
continue it with as many RCs as are requireds receiving 
twenty~four bits of data on each RC. For outputs GISMO will tetl 


the control haw many bytes it has to send» It witl then initiate 


the transfer tocp with a CA ccoamand of TRANSFER OUT Be and 
contirue tt with as many RCS as are requireds sending the data 
out with the FC. 


140 CEAINING 


The I/0 subsystem of the £1000 systes coes not use queues for I/D. 


operationse Using the facilities presented in the preceding» it 


connects alt I/0 descriptors that are directed to the same 


contrels» or group of controis connected by an exchange» in oa 
circular chaine This eliminates the recessity cf an I/0 complete 
interrupt being directed to the MCPs» provided the producer of I/0 
requests» most often a =user program» does not produce the 
requests faster than they can ode satisfied. Ir other wordse tif 
the 1/0 subsystem is compteting operations before they are 
actually required by the user» then the user will never need to 
wait on the corpleticn cf an [/0 recuest and the MCP will never 
have to suspend the program waiting fcr such a completion. 


Even if this isn*t the caser if the user program is forced to 


wait upon the completicn of his I/Q requests» the amount of 
processing that must be done to accoarlish the Suspension and to 
reinstate the program upon coarletion is minimized using 
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chaining. The processing is Limited to ortly that which is 


concerned with program execution and no processing is required to 
tell the I[/N subsystem what it shoulc do next. This information 
is already contained in the I/0 descriptor. 


For all dqevices except tape and disks» then»s the MCP constructs a 


circular chain of descriptors in #mewory. GISMG executes the 
requested operations in turn» as each descriptor is unlocked by 
the MCP. Upon encountering a Lcckec descriptcr>s GISMO simply 
pauses or stops until the descriptor is unlocked. © This wilt 


occur when the user progrém next executes an I/0 request or when 


the file is closed for any reason. If the program must wait upon 
an operations an I/0 complete interrupt is requested» using the 
appropriate tit in the RS fields and the program is suspended 


 pendirg the occurrence of the interrupt. 


DISK 1/0 CHAINING 


The disk I/Q subsystem operates somewhat differently from the 
operation just described. Since each disk I/0 descriptor 
contains a disk address field» it 7S not necesary for = the 
operations to execute in any particular order. Various means are 
provided in the software to prevent ery contention problems that 
might arise» It may be noted that these sase means are necessary 
on I/C subsystems which utilize queueing instead of chaining. 


Atl I/O descriftors for all disk controls that are connected to 


the system are connected in the seme chain. If the system is 
equipped with more than one controlr then each Channel Table 
ertry will poirt to the head of the chéine If GISMO encounters a 
descriptor which is not ready for execution or which is already 
in prccesss specified by the first tro bits of the RS field being 
set ta anything other than 00>» it dces not stop or pause but 
contirues to the next descriptor in the chaine Also» if an 


exception candition occurs» GISM0O dces not stop or pause as it . 


does on other controlse Soth of these acticns are iapecsiied by 
the CHANNEL» NOHALT bit in the Channel Table. ee 


‘'hes Gismo continues Linkirg | in “beth of: the cases _mantioned™. 


aboves it must know when it. has examined alt of the sjcgientene eo: 
an the chain. When it has. examined alt of. the descriptorss it 
aust stop tc free the processor for — other. execution. Tq 


accouplish ehiss the REF.ADDR field in the. Channel Table is used 


to ark the. beginning of the chain. — ‘then a disk operation BS ta? 
dispatched by the MCP» the refererce address. passed by. the 
newvete te is discarded and ene. REF. ADER field 1s used ‘insteads. 
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‘In order to operate properly with cispatch operations occurring 


in an order different from the order of the descriptor tink 
fields» GISMC must be able to override stopping when it has teen 
through the entire chain once.» Fer exéwples if descriptors A» 35° 
and C are present tn the chain and if 8 is dispatched» GISMN wilt | 
link to and initiate 8&8. If» durinc the time that 4 is in 

process» A is dispatched» GISMO must link past C and the REF.ADOR 
field and find and initiate A. 


To accomplish this» the PENDING bit in the Channel Table is used. 
This bit is set by a dispatch operaticn and reset by GISMO~ Tf 
GISMG arrives at the descriptor addressed by the REF.-ADDRP field 


and if the PENDING bit is sets» it does not stop but resets 


PENDIAG and cortinues Linking. If PENDING ts already reset at 
this point» then GISMO stops. | 


Since all descriptors for all disk ccrtrols are maintained in the 
same chains GISMO must be able to reccgnize descriptors which are 
addressed to controls different from the one it 1s handling. 
This is accomplished using the IU.ChANNEL.RS field of the I[I/0 
descriptor. Loon encountering an untccked I/O descriptors GIS 
compares this field to the channel it is executing upon and if 
the two are not equal» it does not mérk the descriptor in process 


but centinues Linking. 


a a ae me ane ‘ene omen Gt <a om 


DISK 1/0 GVERLAPPED SEEKS 


when an I/0 operation is initiated or a moveable arm disk device 
and the arm is presertly positioned to a cylinder different from 
the cne specified in the descrigtors it %S mecessary to 
reposition the arm to the proper cylinder. This operation is 
known as a “seek”. Qn the 81000 systew» all seek operations are 
implicits there is no exolicit Seek operation in the hardware. 
The MCPs initiate disk I/0 operaticrs without regard for the 
current arm position ands if arm wovement is required» it 1s 
accosplished ty GiSM0O» the control erc the device withcut the 
MCP*s participation. The MCP does rot know that a seek is being 
perfcrwhed or required. 7 3 a | | 


Gn this system» ali seek operations are "“overlapped"» This means 
that the arm of any given drive may te in motion simultaneously 
with the arm af any other drive(s). Also» the controt may be 
performing data transfer or any other operation while the arms 
are ir mations ) » | 


This is accemplished by the control returning a result descriptor 


with Eit 175 IOD-RESULT-81T.17>» set tc zerce Esssentially» this 


‘inforas GISMO that some special actior is recessary and that 
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GISMO should not store the result descriptor in memory o In this 
particular case» the controt also informs GISMvO that the selected 
drive is row seeking. GISMO will irittate nc further operations 


upon that drive until informed» by the hardwares that the seek 
operation has completed. 


ocC-2 (Cartridge) and alt disk pack centrols notify GISMO that a 


seek cperation has completed by raising Service Request while in 
status Count te GISMO wilt egair send the descriptor to the 


contrcl and this time» after any required latency period» data 


transfer will occur. DCC-i does rot notify GISMO when a seek 
operation has completed but must te “potted” periodically by 
GISMC. The pause time period for CCC~1l» the tine between the 
pell cperationse is two milliseconds. 


The Disk Subsystem Controtler COSC) offerred on GEM processors 


introduces some exceptions to the statements above. These 
exceptions will be cefined in a sSubsequert version of the 
specification. | | 


TAPE 140 CHALNING 


The chatning of 1/0 descriptors for magnetic tape controls is 
perhaps . the = most complex of the three basic types. The 


complexity is caused by the fact that tape I/0 descriptors 
directed to each separate tape unit aust be executed in Loagical 
sequerce and there may be several such units attached to the same 
contrcl(s). It doesn't matter which unit GISMO addresses next 
but the descriptor that is used to address the unit must be the 
next ftogical cescriptor in the “subchain” for that unite Tt is 
therefore necessary to break the channel chain into subchains»e 


with cone subchain for each physical unit» ard to implement a 


means of remembering the next tecgical descriptor that must be 
used within each subchain. 3 | | 


Both cf these requirements are satisfied by the Lock descriptor. 


Lock is a pseudo I[/0 operation which is handted comptetely by 
GISMG and actuatty causes no physical 1/0 operations. It also 
serves as a means of resolving cortention problems Detween the 
MCPs and GISMC and between two or more tape controls which are 
attached ta _ the same units by an exchange.» Lock operates as 
described below. | 7 | 


The MCP» when the system 1s Clear/Started> constructs a tape 


chain with one Lock descriptor fcr each urit connected to the 
systete The ACTUAL~ENN field of a Lock descrigtor is not used 
and the LINK. field will contair the memory. address of the next 


Lock ceech gears The BEGIN and END) address” fields of the Lock 4 


e 7 Soho eo Ree Bele em ROSE TE a OE EES ILLES O EE ATO Te cap a a PENS SAS I SR NE SR EEL TE Ea a saree. ETT ET re 
Seon pepe SR TE ee pen ENNELY TS OTE Xa es se : es RESUS, Noe ? haa elk il ice 7 : aes NE se 
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descriptor wilt contain the address of the TEST-AND.WAIT I/0 


descriptor that the MCP uses to monitor the status of. each uNTt. 
This is discussed in a later paragrath.e 


When a file is opened on a tape units the MCP changes the BEGIN 
ard END address fields in the tcck descriptor. The MCP now 
constructs a sudchain for the untt which will consist of one 1/0 
descriptor for each buffer requested by the usere~ The BEGIN and 
END éddresses of the Lock descriptcr witl be set to the memory 
address of the first phystcat I/0 descriptor in the subchain = and 
the TEST.~.AND-WAIT descriptor will te removec from the subchain. 
The BEGIN address field witt not he altered from this point until 
the file is Closed. The ENO address wiit be modified by GI5SO0 
each time it executes an operation ir the subchain. In effect» 
The END address field ts used tc remember the next togicatl 
operation that is to te performed or the unit. | 


The LINK fields in each I1/0 descriptcr in the subchain witt alt 
address the next physical descriptor ir the sutchain»s as they da 
for ali cther controls. An excertion te this is the tast 
physical descriptor in the subcheire The LINK field of this 
descriptor will contain the adcress cf the Lock descriptor for 
that unit. This prevent one unit from monopolizing the entire 
contrels it insures that GISMO will periodicaily determine if 
there is anything to he done on the cther units. _ 


The REFsADDR field cf the Channel Tzble entry for a tape chain 
will contain the address of the first Lock descriptor in the 


chaine Gismo» upon receiving a Dispatch for a tape control» will 


discard the Reference Address passsec and start at the address 
proviced by the REF.~ADDR fietd. GIS*C first attempts to tock the 
Lock cescriptcr by swapping O1 into the first two bits of the PRS 
field. IHIf successful» it fetches the address in the END field of 
the Lcck descriptor and proceeds tc that address. If this 
descriptor is untocked» it bheginrs the operation specified. Tf 
not» it returns to the Lock descrirtor and stores the address» 

which ait previously fetched from the END address fietd back into 
the ENG address eee. | - 


Assume now thet the descriptor at the address fetched from the 


END field of the Lock descriptor was unlocked. GISMO begins this 


operation and» assuming that the operation cannot be completed 
withcut some intermediate Service Recuests» returns to the Lock 
deseriptor and continues linking thrcugh the chains.  Eventuallye 
the control will praise Service Request and reference’ the 
initiated descriptor. Upon completicr of that descriotors GISMU 
will store a result and fetch the LINK field of the descriptor. 


~ e: will then proceed to the new descriptor and again check to see 
if it is lockece. If it is» GISMO returns to the Lock descriptor 
for the unit and stores the new address in the END address field. 
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The rew descriptor now becomes the rext Logical descriptor to be 
executed on that unite In this manners GISMO effectively 
waintzeins a logical sequence cf cperatiors that are to he 
performed on any tape unit. | 


It may be noticed from the foregcing that there is no possibility 
of cenflict for a unit between two or more controls connected hy 
an exchanges  sirce GISMO first éttempts. to lock the tock 
descriptor before proceeding down a subchain. Stmitlarty» the MCP 
must Lock the suodchain before alterirg any descriptor in. the 
subchain. | a | | 


The WCP attempts to monitor the steéetus of all peripheral devices 


that are attached to the system. Tc Go this» it must reamenber 
the status of each device and saintain a certain amount of 
inforgzation about eache The major foertion cf the information 


about all of the devices connectec is waintained in the [7/0 
Assiaqnment Table CIOAT).. | | 


170 ASSIGNMENT TABLE 


The I/0 Assignment Table CIOAT) allows the MCP to keep track of 


all peripheral units except the system's SPQ and those devices 


associated with data communication. Each unit ts identified by 
port» channel» and unit numbers as well as by a symbolic name. 
Various fields reflect the status of the unit Ceoge» AVAILABLE>» 
SAVED» REWINCING>» LOCKED). A progragmatic ceeer teen 15 given 
below: | | | | 


DEFINE IOATeSIZE AS #51243 


DEFINE ITQAT~jDECLARATION AS  #£ MELOBAL I oat 
DECLARE 1 DUMMY REMAPS IGAT> © oo | , 7 
| G2 UNTT.INITIAL | | -BIT €66)e Z 
O03)  UNIT.HDWR 7 BIT €6)> 
03 UNIT.PCD | BIT €12)>» % 
04 UNI T.PORT~CHANNEL BIT C7)» Z% 
OS UNIT*¢PORT = | BIT €3)5 2% 
05 uNIT. CHANNEL | BIT €4)» 2 
04 FILLER - | BOOLEAN» Z 
O04 UNIT.UNIT | | BIT (4) Z 
ae C3 UNIT.NAME | a CHAR C6)5 | 
— 02 UNIT-LABEL.ADDRESS _ —DSKeADRe» 
03 FILLER © BIT C12)2— 
7 03 UNIT.PACK. INFO. ee ADDRESS» _ 
G2 UNIT.RS | | |  ADDRESS»% USER LIMIT REGISTER 


a2) sOUNTT<FLAGS —— BITC36)—» 
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UNI Te AVAILABLE 
UNIT Te AVATLABLE EN 
UNT Te AVATLAALE a AUT 
UNTTaWHAITaFORaNQTs | 
WNE Te TESToAND a WAL 
UNI Te SAVED 

UNI TARE WINDING 


T 


WNT TOEQF SENSED 


UNI Teh dd UCKED 

UNI TeLABEL eSENSED 
UNTTePRINT&e BACKUP 
UNI TePURGE 

UNI TeLOCKa ATA TERM 
Pa bl 
UNI TeFLUSH 
UNIT T. TAPEF 

UNE TeOLEKF 
LNITsaSTOPPED 
UNTT.TAANSLATE 
UNI TeCTRLeCARDAUSING 
UNIT TsREMOTE. 08 
LNITeCLOSED 

UNIT TeCLEARED 


AOOLEANe 
AQOLEAN® 
BOOLEANe 
BOOLEAN» 
BNOLEAN®s 
ROOLEAN®s 
BOOLEAN® 
BOOLEANs 
BOOLEAN» 


PeSe 


BOOLEAN» 


BRONLEANs 
BOOLEAN» 


BOOLEAN» 


BONLEAN® 
BOOLEAN 
BOOLEAN» 


ROOLEANe 
BOQLEANe 
BOOLEAN® 
ROOLEAN® 
BOOLEANs 


@fle Safe CF) 


FLUSH TO FOF 


UNITeMULTIOFILE 
UNIT EOT 
UNT Te TAPEOFILEsSTATUS 


ROOLEAN® 
BOOLEAN? : . 
BI1C3) 0% NOT RELEVANT. ANST) 
| BOVCBEG OF VOLUME 
BOFCBEG OF FILE? 
ENVCEND GF VOLUME) 
EQFCENO OF FILE) 
PFBCPROCESS FILE ALK 
* UNDEFINED 
C3 UNTTe TAPE o XCH AROOLEANeS FOR MIS*MATCHED UNITS 
03 he bet ha ROQLE ANe ZPC§ | 
03 UNITAOFFLINE CYETaINell BONLEANe®AFOR ASSIGNED UNITS. 
Q3 UNIT Te AUOIT BONOLEANe &# DMS AUDIT TAPE 
~—603 LUNE TeRESERVED +BY e AG BONLEANe% AUTO BACKUP bel 
O03 UNITeLABEL OP | RITC3Ie% OFROOEOOXA OON TRANS 
% 4ea0QCQOXR OND NO TRANS 
% 22200600Xa EVEN TRANS 
% 37800400KQ EVEN NO TRANS 
BITC4) ox OTSK ONLY | 
1742/3 OPCi/2 OFCI DFC 
N/A NFA N/A 


Anas A OH 


02 ai ie ee 
| | | E 


> 
rc 

=. 

=, 

= 

mm 

Fo) 

| 


UNIT STATUS, _ pr 
UNI Te TNeBEoP ae A 
rILLER | BIT¢ 


- £©& cs 
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02 UNIT.~JNB.NUMBER BITC16)> 
02 UNIT.FIB.ADORESS ADDRESS» — 
O2 UNITLAGEL~TYPE | | BIT €2)> 
z O = OMITTED | | 
v4 1 = BURROUGHS 
% 2 = USASI 
| z 3 = INSTALLATION 
O2  UNIT.TRANS-TBLE.ID BIT(C8)» XZPC-5 TRAIN ID 
02 FILLER WORD»Z PLEASE DO NOT DISTURB 
| G2 UNIT.TEST.DESC RIT CDESCRIPTOR.SIZE)s © 
Ae = =6%mCMC DELI MOI YT raat DEFINE | | 


The ertire IGAT is corstructed by the MCP when the system is 
Clear/Started. Ouring the Clear/Start operation» the MCP directs 


a Test descriftor to each of the controls that are connected to 


the systeme when it discovers a cortrolt that may have more than 
one unit connected to it» it sencs a Test descriptor to each 
possitle unit and wakes one entry ir the IOQAT for e@ach unit that 
is cornected. | 7 | | 


The UNIT-HKOWR field in the [OQAT witt cortain the hardware 
identifier returned by the test descriptor. The following is a 
list cf hardware types and pseudo~types that are supported by the 
MCP. Pseudc-types are used in the device assignment process to 
indicate generic types» such as “any magnetic tape device™ which 
woulc include seven-track» nine~track» phase encoded» NRZ and so 
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DEVICE 


Reserved 


BO col READERsPUNCH.PRINTER | 


80 cal CARD PUNCH 

Reserved 

FOC.1 

96 cal READER PUNCH PRINTER 
PAPER TAPE READER | 

PAPER TAPE REACER@-1 

PRINTER 

READER SCRIER“2 

READER SORTER 


DISK FILE CAny head per track) 


DFC-1 
DCC-2 
DCC~1 


‘pPc-1 | | 
DISK FACK CDCC-1» DCC-25 DPo-1) 


DISK CAny disk) 
DFC-3 C5=-N) 


96 col READER 
PAPER TAPE PUNCH 


80 cal CARD READER 


oPO0-1 


SPO-2 | 
TAPE 9 TRK NRZ 
TAPE 7 TRK NR2 


TAPE PE C9 TRK) 


TAPE CAny tape) 

TAPE.«S CAaAny 9 od tape) 
Reserved 

CASSETTE 

LPC=-5 

QUEUE FILE. 

REMOTE FILE 


PLS. 2212 5462 CE) 
FILE STMT HDOWR TYPE. 

2 OC 
DATASRECORDE RHO 91 
CARC «PUNCH 02 
: 03 
—_ 04 
REACLERsPUNCE PRINTER 05 
PAFERs»TAPE*READER 06 
PAPER.TAPE.READER 07 
PRINTER 08 
REACER»SORTER.2 09- 
REACER.SORTER 1¢ 
DISKeFILE 11 

DISK.FILE.} 12, 
—«OISK.CARTRIOGE 13 
DISK.CARTRIDGE 14 
DISK.PACK.10 15 
DISK .PACK 16 
DISK 17 
DISK FILE «3 18 
READER.» 96 19 
PAPER eTAPE.PUNCH 20 
CARD.READER 21 
| 3 22 
CRI SPO 23 
TAFE.9 24 
TAFE .7 25 
TAPE .PE 26 
TAFE 27 
TAPE.9 28 
29 
CASSETTE Lf 0) 
PC.5 31 
QUEUE bz. 
63 
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In the table above» the File Statewert eoluer (FILE STMT) - is for 
use in the wCPf's FILE Control Card and is explained in the 

Software Operational Guides Generic hardware type numbers are 
not stored in the IQOAT»~ Rather» the actual identifiers returned | 
by the hardware are used. | | a 


UNII MNEMONICS 


Unit mnemonics are also assigned by the CP during the 
Clear/Start process. These mnemonics allow the operator and the 


MCP tc identify devices uniquely. The table below Lists the form 
of the mnemonic that will be assigned to the various types of 


devices. 
Card Reader | | CRx 
Card Punch | 7 CPx 
Data Recerders ; COx 
Printers | a :  LPx 
Tare Units | MTx 
Disk Chead-~ a a none 
Disk Péck 7 QPx . 
Disk Cartridge : pcx 
Paper Tape Readers _ oO PRx 
Paper Tane Punches _ | PPx 
Reader=Sorters | RSx 
Cassettes ; CSx 
FiexinDisk a | FDx 


AtL units will be assigned a three=character mnemonic which 
begins with the first two Letters Listed in the table above. The 
third character will be unique to the unit. The first unit of 

that type enccuntered by the MCP durirg the Clear/Start operation 


“9S assigned the letter “As the second “B" ang so _ forth. 
Assignment proceeds alphabetically ard the mnemonic ace rgnee does. 


nat change unless the systen con rgureeKon changes. 


The assigned unit mnemonic is stored in the ICAT in the UNIT.NAME 
field. The entire IQDAT is maintained in memcry. To minimize 
storage requirements» some informaticn which relates to the unit 


is not stored in the IOAT but is maintained on disk. File | 


Identifiers and any other informatior which is seldom used by the 
MCP are stored in an INTERNAL.-LABEL field on disks The disk 
address of ttis field is mairtzgired in the IO0AT in the 
UNIT-LABEL-ADDRESS field. Informaticn in this field is typically 


updated Cy the STATUS procedure ir the MCP. 


The STATUS procedure is executed wherever the Ready status of an 
umassigned device changes. The *CP is wade aware of a status 


change by TEST.ANC.WAIT 1/0 operators. These’ operators. - not 
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truly wait on aiunit status change cut this function. 4s emulated 
by GISKO. 


: ecana I/0 OPERATORS 


The MCP must know when a unit goes from a Not Ready condition to 


a Ready..condition so that it can reed the tabet on the media and 


update the INTERNAL-LABEL information on diske It must know when 
a unit changes’ from Ready to Net feady so that 1t can mark the 
unit unavétlable and initiate a TEST.-ANDeWAIT“FOR-READY on the 
unite. TESTeANDeWAIT operations etlow the specification of 
certain conditions fcr completion» such as Test and Wait for 


Ready» Not. Ready» Ready to Transa#it» Reacy to Receive and so 


forthe. GiISMO will net consider the cbeta seen, complete untess the | 


| sree conditions are met. 


On disk and tape controls» which allow more than one unit per 
contrcls»s we cannot tie up the entire control with a Test and Wait 


operation to one unite For OCC-2» all disk pack and att tape 
contrckls» the PAUSE bit in the Chanrel Table is used to implement 


a. periodic test of alt such units. ft each 100 millisecond timer 
intervals GISs0 searches through the Channel Table tLooking § for. 


entries with this bit set to zerc. When such an entry is found» 
GISMO initiates that chain at the adc¢ress specified by REF.ADDR» 
also in the Charnel Table. During this execution» GISMO will 
initiate all Test operations enccuntered in the chain. If the 


conditions fcr completion specified in the operator have been 
met» GISMO will store the result cescriptor returned by the, 


operation and queue an interrupt for the MCP; the MCP always 


requests. an irterrupt in Test and. Wait descriptors. 


The MCP also sets the type. fietc of this I/0 descriptors 


IO.MCF.I0» $$.tc a value which indicates “Status Change". In the 
MCP*s I/0 Complete procedures which is invoked only when = an 
interrupt is returned from an [70 operation» the value stored in 
TOQ.MCP.IO will cause invocation of the MCP*s STATUS Procedure. 


“sTAius eeocenuse 


As mentioned previously» the STATUS Procedure is executed only 
mhben the stéetus of an unassignec ee changes. If a 
peripteral is being used by a prograa and if goes to ae Not 
Ready conditions the situation is handted by the 1/0 Error 


Procecure. — Khen an assigned peripheral goes from Not Ready to. 


Ready» no action is required by the WMCP since the Test and Wait: 7 
descriptor executed ir this case wit! have a LINK field set to... 
the next togical operation to be perfcrmed on the devices | 
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Perictheral devices which are capable cf 


have tlabets written on the 


recogrize several daifferent 
devices and 
devices which have 


medide 
Labet 


it expects to read contrcl 
input capahilities. 
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‘input operations usually 
The 
formats on ditsk and tane 


MCP is equipped to 


Instructions from alt card 


Control instructions are 


qdiscussed in the Software Qperatignal Guide and in Product 
Specification 2219 C144» 


discussed here. 
for: irput purccsess 


: MCP 
Essentially» 


Cortrol Syrtax and will not be 
when a card device becomes’ Ready 
the Status Procectre reads the first card and 


contrcl is passed to the Cortrol Carc Procedure. 


Gn disk and tépe deviceser 
Procedure attempts 


devices» the MCP is capable 


DISK IDENTIFICATION = PACK LABELS 


Every disk packe 
identified by 4 standard “ANSI*™ 
written in EBCBIC C8 bit code)» 
bytes)>» 


disk cartridges 


when a uritt becomes Ready» the Status 
to read a tabel frcem the meciae The following © 
as a description of the various tabet formats» on disk and tape 
of recogrizing. | 


or head-per-track sub-system is 


peck label. $$ This pack tabel> 


: is two pack sectors Long (360 
and eccupies the first two sectors on a pack» TeEeo» 
cylinder QO» track 2» sectors 0 enc 1. 


C43 


qgdentification information and sector 1 is 


Sector 0 contains pack 
reserved for future 


implementation of pack: security procedures. A programmatic 
description is given FCelow: | : 

DEFINE PACK»LASEL»~DECLARATION AS #2 

DECLARE O27 DUMMY REMAPS PACK.LABELZ 7 

» C2 PL.VOL1 CHAR (4) % —"VOLiI"” 

» O2 PL~SERTAL~jNO CHAR (6) 2% | SERTAL CCAN) NUMBER 

» O02 PL.ACCESS. CODE. CHAR C1) 2 ACCESS CODE 

» 02 PLAID | CHAR (C17) % PACK ID 

» 03 PL.NAME CHAR C10) 2% 

p C3 FILLER CHAR €7) % 

» OZ PLeSYSTEMsINTERCHANGE CHAR (2) 2% SYSTEM INTERCHANGE /CODE 

| ie 2% 00 = INTERCHANGE 
% 17 = B1000 INTERNAL 
Z 35 = 83500 INTERNAL 

| ETE ye ETCe ETC _ | 
es 02 PL.CODE CHAR €1) 2% PACK CODE 00 = SCRATCH | 
» 02 FILLER | CHAR C€) 2%) : | 
e O02 PLaOWNER.ID CHAR (14) 2% | | 

» O02 PLeTYPE — CHAR C1) % eRe = RESTRICTED PACK 

| | a "uy = USER PACK 

2 td Pa 7 _. & Se S$" = SYSTEMSPACK 

» O02 PL.CONTINUE CHAR C9) = 2%) 5 CONTINUATION FLAG neo 
» G2 FILLER | CHAR C2€) 2 

2» Q2 PL.INT CHAR (1) 2% ee ae 

» 02 PL.VOLZ CHAR a — *vOL2" 
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» 02 PLeDATE~INITIALIZED CHAR (5) 2% | _ | 

» 02 PLe-INIT.SYSTEM CHAR (6) 2% INITIALIZING SYSTEM 

» O2 PL.DISK DIRECTORY CHAR (8) & DIRECTORY ADDRESS 

» G2 PLeMASTER~AVAIL | CHAR €@) 2% MASTER AVAILABLE TABLE 
» O02 PLeDISK.AVAILABLE CHAR C8) 2% WORKING AVAILASLE TALE 
, O2 PL.~INTEGRITY } CHAR C1) 2% O = NORMAL | 

= 4 —_ | | z 1 = RECOVERY REQUIPED 

_ O2 PLeERRCR-COUNT CHAR (6) 2 OS 

p G2 PLeSECTORS.XD CHAR C6) 2% REMOVED SECTORS 

» O2 PL«~TEMP.TABLE CHAR €8) Z% TEMP TABLE LINK 

» 02 PL.PCD | CHAR €33 % LAST PORT» CHAN» DRIVE 

, G2 PLeASSIGNED.T0.BP5 CHAR C6) 2% BASE PACK SERIAL NUMBER 


Irn the case of disk devices» additicral information» beyond that 
which can be stored in the ICAT» is required by the MCP for 
proper aperation. The STATUS Procecure and cthers maintain this 
information in a reserved area ir memory known as the Pack 
Information Table CPACK.INF(Q). | 


PACK INFORMATION IABLE 


The peck information table is an MCP waintainec Linked tList of 
all ouser disk packs and cartridges currently on tine. tt 
contains such information as the nage» sertal rumobder » hardware 
units number of users»e and addresses of the disk directory» 
available table» and temporary table. This structure allows a 
pack or cartridge to be externatly referenced by name. A 
programmatic description is given below: | 


DEFINE PACKeINFO.DECLARATION AS #2 
DECLAFE C1 DUPFY REMAPS PACK.INFO> 


O02 P.sNAME NAME» 
O2 P.SERIAL.NC WORD» 
QZ P.»DISK.DIRECTORY DSK. ADR» 
O2 P.DISK-AVAILAELE DSK «ADR» 
C2 PeTEMP.TASLE | DSK»ADR» 
02 P.UNIT.NAME i CHAR (6)> 
02 P.PCD = BIT «C129% 
03 PePORT~CHAN = BIT (C725 
03 FILLER BIT (1)> 
| 03 P.DRIVE.NO BIT (4). 
OZ PsNOWUSERS BIT (8), 
02 PeNOMPF.USERS ~ ‘BIT C8); 
QZ PeTOsBE-POWERED.DOWN BOOLEAN» | | 
O02 PsRESTRICTED BIT €3)5 2% 0 = SYSTEM RESOURCE PACK 
Me | | | %Z 1 = RESTRICTED 
% 2 = UNRESTRICTED USER 
_ a % 3 = INTERCHANGE | 
02 P.CONTINUE | BOOLEAN» % 1 = CONTINUATION PACK 
Zi = 


02 P.SCRATCH =  ——- BOOLEANs SCRATCH PACK 
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O2 P.FULL oe BOOLEAN» % 1 = NO MORE AVL DISK 

O02 P.XC | BCCLEAN» ZPACK HAS UNDERGONE XC. 
Q2 PeASSIGNED.T0.BPS WORD » Z ASSIGNED TO BASE PACK # 
02 P.LINK AD DRESSS 

Bon | 


TAPE LABELLING INITIALIZATION AND PURGING 


MCP II includes the capability toa create and recognize 


two 


different foras of magnetic tape tabels- The standard Label 
format for the 81000 system will conform to that specified in the 
publication entitled “The American Nationat Standard Maqnetic 


Tape Labels for Information Exchange" which is dated 1969 and 
‘published by the American Nationet Standards Institute» Inc. 
CANSII). These labels are commonly known as “ANSITI» Version 1" 


Labels. It should be noted that “standard Lebel format” for the 


Syste means that any program which requests standard labels 


in 


its fite declaration with cause ANSIT labels to be written when 
the file is assigned to magnetic tape» and the file is opened 
outpute Users are allowed to create the tabel in ASCIT if they 


so desiree 


ANSII labels as implemented on the B1000 system contain several 


ageviations from the standard as presented by the ANSII documents. 


The deviations are necessary in crder to irsure that we 


are 


compatible with the 86700 systems the most noteworthy deviation 


is the recording node of the tabel itself, it is written 


the “SN* command. 


ANSII tabel format» as implementeds consists of three physical 


in 
 ERCOIC character code untess ASCII is specificalty requested via 


blocks on the tapes followed by a tape marks. The first of the 
three blocks is known as the Voluwe Headers $A programmatic 


description is presented below. 


ot VOLUMESHEACER = ae 
QZ FILLER CHARACTER C4) 


| ZThis field will always contein “VOL1" 
— 02 VOLUME.ID ‘ 4 CHARACTERC6) 
62 ACCESSABILITY ~— CHARACTERCL) 


£This) field is not used by tte 81000 | 
G2 RFS 2ZThis fielc is reserved ir the ANSII Standard. It 


is 


Zbeing used as follows by the 61000 and the Beets: 


oo 03 MULTI.FILE.ID CHARACTERC17) 
: z "0" if there is no MFID -_ 
% "x0" if Scratch a 
. oo Z “BACKUP” if. Backup. 
03 SYS-SYMBOL CHARACTERC2) 
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y 4 Witt contain "17" if created or 21000 

O2 TAPE.TYPE CHARACTERC1) 
2 0 = Scratch | 
z 1 = User 
2 2 = Backup 
2% 3 = Library | 
; 03 FILLER : ; CHARACTERCE) 
O2 OWNER.IC CHARACTERC14) 
2 This field 1s not currently usable on the 81000 system 
92 FILLER , CHARACTERC28) 
602 «€6VERSION | CHARACTERCI) © 
& Wilt contain “1" until such time as the Label format 1S 
. & chanced : | 


The second of the three physical blocks is known as “Header ne” 
The fcermat is aiso used for Endroaof"Filte and Endtof“Volume. A 
programmatic description ts given belcn. 


O1 HEADER1.DECLARATION 


02 FILLER CHARACTERC4) 
Z May contain "HRDI"» “EOFI"» cr “EQVi" 
02 FILE.1D | | CHARACTER(17) 


OZ FILE.SET. ID | | CHARACTERC6) | 
a % This field will contain the first six characters from 
Z% the MFID field in the VOLi block | 


O2 FILE-SECTICAN.~jNO CHARACTER(C4) 
| *% Used for Reel number by B&7C0O and 81000 
O2 FILE-SEQ-.NO CHARACTERC4)  — 
Z% Ordinal number of the file within a Multi-File 
02 GENERATION.NO CHARACTERC4S) % Unused 
G2 GENERATICN.VERSTON-NO CHARACTERC2) Z Unused 
G2 CREATION.DATE CHARACTERC6) Z bDYYDDD 
02 EXPIRATICN.DATE CHARACTERC6) Z bBHYYDOD | 
O02 ACCESSABILITY CHARACTERC1) Z Urused | 
O02 BLOCK.COUNT CHARACTERC6) | 
Z Zero if this is a Header.One block 
02 SYSTEM.CODE 7 CHARACTERCI3) Z% "B1700" 
02 FILLER — . CHARACTERCT) 
The third physical block is known es “Header Two". It is also 
used at End-of-File and End-of-Voluge. Its format is shown 
below: | 7 — 4 oe = 
01 HEADER2- DECLARATION | , 
O02 FILLER | , | CHARACTERC4) | 
2 May contain "HDR2"» "EOF2"» cr "EQV2" 
02 RECORD. FORMAT | CHARACTERC1)- 
- 3 2 Fo = Fixed. : 
Zz V Variable 


Wu 


zs Spanned (Not yet iaplemented by any) Burr oughs system) 
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x U = Undefined 3 
O2 BLOCK.LENGTH CHARACTERC5S) 
G2 RECORD.LENGTH CHARACTER(S) 
QO2 RESV-SYSTEM.USE | CHARACTERC35) 
03 DENSITY CHARACTERC1) 
2 C = > 800 
Z1= > 556 
2 £ = > 20C 
ZX 3 = > 16000 
03 SENTINAL | CHARACTERC1) Z% Unused 
03 PARITY CHARACTERCI) © 
2 0 = Evens 1 = Odd 
QO3 EXT.FORM CHARACTERC1) 
2% C = Unspecified : 
% 1 = Binary 
Z 2 = ASCII 
Z% 3 = BCL 
% 4 = EBCDIC 
03 FILLER CHARACTERC31) 
O02 BUFFER.OFFSET ee CHARACTERC2) Z Unused 
 ~=6O2 FILLER CHARACTER(C26 ) 


| As mentioned ina prior paragraphe the MCP writes ANSII Format 


labels on tapes whenever a file is opened output and the 
LABEL~TYPE field in the FP3 is set to zero. If the user wishes 


to'certinue writing the old Burroughs format tabels» he must 


modify this fietd in alt of the files in his programs. This may 
be accomplished by recompilation» by the use of a File Attribute 
commuricate creration within the frograns by the use of the 


MODIFY control instruction or by the use of a FILE card when the 


program is executed. Presently valic values for the LASEL.TYPE 
fieta are: | | 


ANSIT. 
LUnlabelled 
Burroughs 


Hou 


0 
1 
2 


ANSII Labels» though they are writter when the file is opened 
outputs» are actually created on all saanetic tapes prior to that 
time A keyktcard message has been igplemented in the MCP for 
purpcses of creating the initial ANSII Label on all tapes. The 
mnemoric of the message is "SN" whict used to be an acronym for 
serial Number. “fhe Sy tax for SN is: | 


SN <unit mnemonic> <voluae-identifier> 1 ASCII 1 


<Volugse identifier> may consist cf one to six alphanumeric 


characters and is inserted in the VOLUME.ID field of the VOL1 
block of the label which is created. — This operation ise for 
conversational purposes» known as “iritializing”™ the tape. Atl 


tapes and cassettes must de initistized on the £1000 before the 
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MCP will consider them scratch. This Spaties to seven=track> as 


well as all versions cf ninemtrack tépes. 


The <volume identitier> keyed in will remain on the tape until 


the tépe is re~initiatized. The tape may be purged at any time» 

provided the ANSII tabet is stili intact on the tape. Tapes 
which have Surroughs tabels on them sust be rerinitiatized and 
may nct te purced. Purging» here» implies the use of the "PG" 
keybcard message. Similarly» unlabelled tapes may not he purged» 


but méy be rewinitialiede. The <voluse identifier> is now part of 
the cutput of the *“OL" nessage. The fgresence. of the reserved 


word ASCII in an SN statement causes the label to be written in 


ASCII character codes. 


The capability of creating and recogrizing ANSIT labels was not 


included in the MCP prior to the £.0 release of the software. 
Before the 5-C releaser alt Labels created by the B1000. system 
were the old Burroughs tabels first implemented on the B5509 
System. A programmatic description cf these tabels» as they are 
created on the B1000% is shown belcwe AS can be seen from the 
descriptions certain fields have beer added to the tabels to 
imprcve their utility. These fields are meaningful to the 81000 
systew only. A programmatic description is presented belowe 


DEFINE STANDARO.LABEL -DECLARATION AS # 2 
DECLAFE 01 DUMMY PEMAPS L»LABEL-RECORD 2% 


» O02 LeLABEL CHAR (C9) % " LABEL o* 
» 2 LeMFID CHAR (7) % gs 
» G2 1.21 — CHAR C1) 4% eon " 
» 02 L-ID CHAR C7) %- 
» O2 LeREEL CHAR €3) 2% 
» G2 L.DK CHAR (5) 2% DATE WRITTEN 
» OZ L-CYCLE CHAR (2) 4% a | 
» G2 L.PID CHAR (5) 2 PURGE DATE 
» G@24-48 CHAR C1) % SENTINNEL (1 = END-OF-REEL) 
p 02 L-B8C CHAR (5) 2% BLOCK COUNT © ; 
’ O2 £-RC © = CHAR C7) 2% RECORD COUNT  _ 
» O62 L-PB ‘° CHAR C1) 2Z PRINT BACKUP FLAG 
» G2 LeSERIAL CHAR (5) 2% SERTAL NUMBER. 
» O02 LeSYSTEM CHAR (5) 2% CREATING SYSTEM | 
r 02 LeBUFSIZE. CHARC8) 2 NEW FORMAT DECIMAL BLOCK SIZE. 
- O3 LeBSIZE BITC24) 2% OLD FORMAT BINARY © 
e O3 LeRSIZE’ BITC24) % CLD FORMAT BINARY 
» ©2 LeRECSIZE CHARC8) 2% NEW FORMAT NECIMAL RECORD SIZE 
» 02 L.MODE CHARC1) = 8% NEW FORMAT RECORDING MODE FOR 
| % TAPE FILE 


Ne 
es 


ALL Labels on the B10900 systea are written in odd parity. 


Beginring with ithe 4.2 release of the softwares tape marks are 
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written if ever parity» except where crohibited by the control. 
This was done as an accomodation tc the B30C system» which can 
read cnly seven~track tape and cannot recognize tape marks which 
are written ir odd parity. 


MCPIT with write tapemarks and ending tabels on any output 
labeled tape that is not at BOT when a Clear/Start is done. This 
will aitow the user to read thét tape ard recover the data. 
There is one restriction. If the tépe is to be read in reverse 
the user must specify blocking inforsation. | 


ANSII labels are also written as the standard tabetl = on 
seven=track tapes. When this is done» the Labels are written with 
translation to BCL. Burroughs tLabels» when written toa 


seventrack taper, are written ir ode parity with the EBCDIC/ECL 
translator enabled. | 


The STATUS Procedure makes all pessible atteepts to recognize a 


tabel when a tape unit becomes Readcye . On seven-track tape» 
particularly» there are several different variations of parity 
and recording mode that may have teer used to create the tape. 


Sevenvtrack tape car be written with or without character 


translation from EBCDIC to 8CL. The MCP wittl attempt to read 
tape Labels with alt possible variaticns before giving up. 


Khen the MCP cannot recognize a téebel» the unit is considered 
available for input purnoses if the tape does not have a write 
Ring in ite In this case» itt ust be manually assigned to a 
progrem by the operators either wher the. crogram requests the 
file or when the job is executed. If the tape does contain a 
Write Ring» it must be initialtizede using the 3N instruction 
agecsribed above. Oniy when the tape has a Write Ring and 


contains a valid ANSI label indicating “Scratch” is it considered 


availebte for output purposes autcmatically ey the MCP. 


It ais atso the responsibility of the STATUS Procedure to record 
the cther information returned by the Test I/0 operation. This 
information 4s crucial tc the proper operation of the tape 
subsystem. In particulars if the system is equipped with a 


PE/NRZ  excharge» the operation of the STATUS Procedure when a 


unit bteccmes Ready is as described belcw. 


oto Pre Sceseh eS Pass Pete ee Pe 


Ake dw Proce tas he ah eto ree 
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PEANRZ EXCHANGES 


With the tncluston of the M4/M5 WEC supplied by the Westtake 


Plant and describec by P.Se- #2047 4490» it is possible for a 
tape unit to operate in etther Phase Encoded (PE) or NonwReturn 
to zero (NRZ) recording mode. This can only be accomplished on 
the £1000 hardware by connecting one NRZ control and one PE 
contret to the MEC. The NRZ control is designated MTC-2 and the 


PE cortrol is designated MTC~4. <A tépe subsystem so connected is 


spoker of as an exchange subsystem by hardware personnel. 
According to the software definition cf a subsysteme all controls 
in the subsystem must be identical. The code in the [/0 driver 
which interfaces to MIC"2 is distinctly different from that which 
interfaces with MIC~4.: <A request tor a unit which is operating 
in the NRZ mode can orly be handled by MIC“2. 


To sclve this problem» considerable ccding has been incorporated 
in the MCP. The problem has been rectified ir the most efficient 
manner possible» however. Two sepérate chains of descriptors» 
one for each controt» are constructed by the MCP at Clear/Start 
time. Tne two chains are maintained by the MCP dynamically» from. 
that point. 


Recording mode information is supplied by the test operator and 
actually is returned as the density field in the result 
descriptecr. A density selection cf 16C0C bpir for example» 
indicates that the unit has been selected to be in the 
phaseencoded recordirg mode and that the I/0 descriptors for the 
unit should be in the MTIC"4 chain cf descriptors. If the 
subchein for the unit is not in the proper chains the MCP will 
move the entire subchain to the proper chaine The movement of 
the subchain is only attempted wher the unit is not in uses of 
course. Selecting a different density while the unit is being 
used constitutes an error on the part of the operator. The 
operator is notified of the error anc the program is allowed to 
continue ‘processing .onlty when the proper density has been 
selected on the unit. | | Oo | 


This solution is only possible if both controls are capable of 


reporting reccrding density properly. MTC“2 can report the fact 
that a unit is selected to te in the 1600 bpi_ density. 
Similarly» MTC-4 is able to report the fact that a unit is in the 
800 bri density.e Density information is commonty used by the MCP 
only when a unit goes from a notctready state to a ready state. 
The mcvement of the subchain is therefore performed by the MCP 


- status routine when the unit beccses ready. 


Unit mnemonics are not affected by the presence of a PE/NRZ 
exchangee- A unit selected as MTA» for exaaples will always be 
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known as. MTA» peaardtece: of which chain contains its. subchain» or 
which density is Sones ted by the operator. 


Due to differences in the unit nusbering scheme between MTC~-2 and 
MTIC~4>» there can he no more thar eight magnetic tape units 
connected to a PE/NR2Z tape subsystem. This capability is not 


available on any version of the software prior to the 5.1 release 
versicne 
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FILE SIRUCTURE 


A File is a group of related records. Files are of central 


Importance in the I/0 Subsystem since effectively all of the 
comgmurication bhetween user progranas and the subsystem 1S 


accorarplished through files. 


The £1000 Operating Systenr supports three different file tynes or 


structures» exclusive of Data Manageaent System structuress which 


correspond raughly to those file types defined in the ANSI "74 


COBOL Language. In that tanquage» these types are catted 
Sequertial» Felative and Indexed Sequential. sequential and 
Indexed Sequential files» in COBOL» can both te accessed ir a 
randot manner and the use of the wera “Sequential” tends to add 
confusion. In this documents» the three types will be ref ferred 
tc as Conventicnal Ftles» Relative Files and Indexed Files. 


CONVENTIONAL FILES 


The basic definition of Conventional file structures is found in 
the CCBOL "68 Language» theugh many functions have been added to 


the Easic definition. To a oprcoraa» a file represents a large 
collection of crdered data that exists apart from the program. 
The program needs to interact with parts of that data from time 
to tive and the I/O Subsystem makes this interaction pessible. 
The I/0 Subsystem moves the data into and out of user working 
areas in sain memorys to which the pregram has access. 


The unit. of data movec. into ana cut cf the user's working area is 
the record. The record is considered» by the 1/0 Subsystems to 
be a string of bits» which the user program will probably group 
into. Characters or words in’ some manner» but the I/0 Subsystem 
deals only with entire records and celivers and receives one 
record at a time to and from the user prograt. 3 = Oe : 


A. file has some structure — ‘as seer by. the user. program. — The. 


records may be allt of the same Length or they may be of variable 
Length. Lerncth information must te declarec by the program or 
contained in the record itself or exist in an accessible form in 
the chysical file cr exist ir the information which the MCP 


maintains about the file. If the recerd length is variables then | 


the tength of each record must exist in ‘that records in the first 
four. character. positions. | 7 | fe ws eg 
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The file» as it is stored on some reccrding medium» is often 
refferred to as a physical files A physical file may have some 
additional elements of structure. It may contain blocks. A 
block is a group of physically ccntiguotus records which are 
transferred to and from the physical medium as a groupe The 


storage device itself may imoose some structure upon the file. 


As discussd previously» data is transferred ta disk in 1446~bit 


increwents. A block of records to be written to disk must 
therefore total some integer multiple cf 1440 bits. The disk 
itself may te used to store many cisjoint chysical files. To 
minimize storace ieee ad protleas»s the MCP allows disk files 
to be broken into “areas™ each of which will contain room for a 
specified. eee of blacks This as described itn more detail 
later. | a) 


The —gchysicat file inherits mary of its properties from the 
logicat file declared by the user prcoram which creates ite When 


the user programmer declares a togical file» the compiter 
generétes a File Parameter Block which contzdins the specified 
values for the various attridutes cf the files. File Parameter 


Blocks C(FPBs) are defined in Section 2 of this specification. 
The MCP» and more specifically the CPEN procecures converts the 
attributes specified by the user to an actual physical file. 
Mcre attributes are added to the physical file when it is 
assigred to a cevice. 


Any file way te described by its attritutese File attributes are 
System cantrel parameters which are used by the I/0 Subsystem. 
The attributes contain att of the information the subsystem needs 
when it connects a physical file te @ logical file declared in a 
user program and when it controls the access to that  physicat 
file. 


7 7 , 4 G & ” - 
Most of the attributes associated with any file are contained in 


the File Parameter Block CFP3) for ttat files Certainty» the FPB 


is the storage medius for che attrikutes that are declared by the 


user and generated by the compiler. Additional attributes witt 


be attained when tte file is cpered and assigned to a device. 
Wheh a file is opens its attributes say be stored in the FPB» the 
File Information Block CFI8)» the Disk File Header CDFH) and the 
I/G Assignmment Table CIOAT). ALl cf these structures have been 


presented previously. 


Sautntine with the 8.0 version cf the MCP» a communicate 
operation was added to allow user pregrams to dynamically modify. 
selected attributes of a file. Ir subsequent versions of the 
MCP» the tist of modifiable attribtes has been expanded. ~~ The 
File Attribute communicate operaticr is described in the Demand 


Management section of this document. 
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FILE NAMING CONVENTIONS 


ALL names associated with files on the B1000 CP may be a maxiaum 


of ten characters in length. Names in excess of ten characters 


will be truncated to the first tene Looking at the description 
of tte FPSB presented -in Section 2 cf this specifications the 
first field in the FPB» FPB.FILE.-NAME is the internat name of the 
fite. “Internal"» in this cas@€» means internal to the user 
programe This is the name which aprears in the Fite Declaration 
of the user program and the name which the programmer uses in alt 
references to the file within the prcoramas 


The next three name fields in the FPB provide the “File 
Identifier” for MCP curposese. Att chysical files tntroduced to 
the system may have one or two names. Files assigned. to disk 


pack may have a third name which witl correspond to the pack 


names the name contained in the pack Lebel. 


If a file has one name only» that name is stored in the field 
FPBOMLLTI.FILE.G0 and the field FPH.~FILE-ID sheuld be filled with 
blanks. FPB.MULTI-FILE-ID is often referred to as the "Family 


ID" and is onty important if the file is assigned to disk or 


tape. If a file has two names» the second name is stored in the 
FPB. FILE. ID field. 


The assignment of physical files to tegical files is discussed in 


the Demand Management Section of this specification in the 
description cf the OPEN communicate cperation. Stated in its 
sia@plest forms the MCP attempts to éessociate one or two names 
with each device that is connected to the system and that is 
capable cf input operations and to #wétch this external name to 
the File Identifier scecified in an FPB when a user OPENS a file. 


Qn output files» the MCP simply attempts te assign an availabte 


device ot the requested hardware tyPee 


There are two exceptions to the statemerts in the preceding 


paragraph. When an output file is cirected to Printer or Punch 


devices» the cutput data may be actuatily stored on disk for later 


retrieval. Such files are known as Backup Files and are. 


discussed tater. Input card tiles way be Loaded to disk files. 
prior to the time they are required ty a pregrame When the 
program then requests’ the card. files MCP may automatically 
substitute the previously taaded disk filese This is known as 
the Psuedo~Feader facility and ts discussed itn Product 
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LOGICAL DISS EJLES” 


It is the MCP's responsibiltiy to corvert a legical disk fite as 
declared in & user proyrams to gr actual physical. disk file. 


This can only occur by a program opening a new disk file>» uhere 
"new" in this context specifies that the program intends to 
create a file and the physical disk files that are currently 
known to the system are of no concerr to the user. 


Except in the case of Multi~Pack files» files that extend over 
more than one physical pack or cartridge» anew file can onty 
become a rermarent file that exists when the program is no longer 
executing by the same user doing a close operation on the_ fite 
and srecifying in the CLOSE commuricete operator that the file is 
to becowe permanent. This implies that the file identifier is to 


pe entered in the disk directory and remembered by the MCP 


forever. This also implies that the disk stcrage space occupied 
by that fite is to be used for no other purpose except the 
various user manipulations that méy occur within that files 
utilizing a togical file with the same File Identifier. The 
Close operation is atso described in detail in the Oemand> 
Management section af this specificéeticn. Basically» the Open 
and Close operations. both obey the rules presented tn the 
defirition of the COBCL Language. - | | 


‘PHYSICAL DISK EILES 


in. crder to manage all of the available storage space on a disk 
devices the FCP must maintain tables which telt it the storage 
lccations that ere available for use» the names of the files that 
are already stored on the disk and the physical characteristics 
of thcse files. | oo 


DISK SPACE ALLOCATION 


There are three tables» each with the same format» that are used 
oy the MCP to allocate disk space» The master available table is. 
a nonvexpandable table of three contigquous segments beginning at 
the second sector on diske It contéins a List of all unusable 
segmerts which have been "XD-eda" by the operator. The working 
availéeble table is 3 10-segment table bLeginnirg at the 47th disk 
segmerte It contains a List of alt available or unused space on 
disk end is expandable as needed. Ihe temporary table is five 
contiguous segments and contains ~ list of all segments in use 
but not reflected in the disk directorye This expandable table. 
begins at the 57th sector. At Clear/Start time» att sectors in 


the temporary table are returned to the available table. A 
programmatic description is given below: “s | 
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DEFINE 
DISK .AVAILASLE. DECLARATION AS4- 
DECLARE | 
— «O01 DUMMY FEMAPS OISKSAVAILAS3LE BITCSEG. SIZE)» 
O02 AVL.~FOR-LINK DSK-ADR» 
O02 AVL.BACK.LINK DSK»ADR» 
O2 FILLER | BITC4)>» 
O2 AVL-~BLOCKC22)» | 
OS AVL ADDRESS © DSK ADR » 
03 AVL-~LENGTH WORD> a> 


FILE ACCESS AND IDENTIFICATION 


The disk directory is the structure which catalogues and points 
to all files cr disk.» Each entry cortains the file's namerp type» 
and Disk Fite Header (DFH) address-e The dtrectory is a two~level 
structure containing a pri@ary cr “master” directory and a 
secondary directory. |The master directory is created at Cold 
Start as 16 contiguous disk sectors teginning at sector 31. Each 


sectcr contains entries for elever files. As each sector is 


fillecs another disk segment is allecated and linked to the 
filled sector. If a file has two names» the primary name 
CMulti-File ICentification) is plecec in the master directory 
with a pointer to a secondary directcrys» where all the files with 
that MFIU are listed» The secondary directory is structured and 


Linkec in the sate fashion as the master directorye. A 


progrémmatic description is given betcw: 


DECLARE O1 ODIRECTCRY FEMAPS BASE> 


02 OLSK.SUCCESSOR OSK ADR» 
O02 ODLSKePREDECESSOR DSK.»ADR» 
02 DISK.SELF | DSKeADR» 
02 FILLER | | BIT €12)> 
O02 DISKsNAME NAME» 

O02 OLSKeADDRESS | «DSK .ADR>» 
O02 DISK.FILE.TYPE BIT (4), 

O02 FILLER | BIT €1260)5 2% 11 ENTRY PER 


The Cisk File Header (DFH) is a variable-Lenath header records 


the size of which is dependent upon the number of declared areas 
in the file ard 3s eoneures as follons: 


540-BITS + C36-BITS * NUNBER-CF-AREAS) 
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‘The DFH: is never less Hien 1L4A0 bits nor greater than (4320 bits 
on diske It lists the odhysicat characteristics of the file 
including its file tyre and the disk address for each area. The 


follcwing file types are recognized -Ly the MCP: 


LOG 
DIRECTORY 
CONTRGL DECK 
BACKLP PRINT 
BACKUP PUNCH 
DUMPFILE | 
INTERPRETER 
CODE FILE 
DATA FILE. | ; 
VARIABLE LENGTH RECORD DATA FILE 
INTRINSIC FILE 


a om ame am 2S Ah a Cee EP a ae ce 


As discussed oreviousty» Disk File Headers (DFH) are the 
structures used to identify a fite on diSke It is a 
variable-length recerd which descrites the ohysical attributes of. 
the file and contains pointers to each "area™ cf the file. When 
a disk file is “opened*» 3g copy of tte DFH is copied into memory. 
The header in memory points to the header or disk and vice verSae 


There wilt never be more than one copy of the header for a file 


in menory at any time. Multiple users of the file will use the 
same copy of the header. Maintenance of disk file headers is 
covered ir another section. A programmatic description is given 
below: | 


3 = FILE HEALER 


DEFINE FILEsHEADER. DECLARATION AS 4% 
FE.MAPCFILEWHEADER) #> 
EHeMAPCFILE. HEADER) AS #2 | 
beCLage O1 DUMMY REMAPS FILE.HEADER»2 | 
O02 FHsUSERS.RANDOM BITC8) +2 FORMERLY FH. CORE. ADDR 


O02 FHNEXFILE BITC1)»+% CLEARED WHEN NEW FILE IS FILED. 
OZ FILLER } BITC7)> 
02) «FHeFILESKIND | BITE)» 
02 2) «FHA SELF. DSKADRs 
G2 FH.NG.USERS BI1 (€8)> 
- 02  FHeUSERS.OPEN.OUT «BIT C4), 
02 FH.OPEN. TYPE ee B11 (4)> 
C2 FHeFILE.TYPE | BIT C4), 
G2 FHLPERMANENT —- ATT (4)> 
«02 FHA JOB.WAITING.ON.CLOSE BOCLEAN> | 
02 2 «FILLER BITC9)» % DON'T USE UNTILL 1977 


a 
2 
| 
a 
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02° «FHHOR.SIZE 

O02 FH. NOUSERSeLOCK 

| Z% NO.USERS WHO 

O02 . FHeRECGRD.SIZE 
O02 FILLER 

C2 FHeBLOCKS.AREA 
G2 FHaSEGS.AREA 

02 FHeAREASeRQST 
G2 FHeAREA.CTR 
(02 FHeEQF.POINTER | 
G2 FILLER 

O2 FH.8PS.NO0 

C2 FHeBLOCK.COUNT 
O02 FH.FORMAT | 


02 FRK.MPF 
C2 FILLER 
O02 FH.CREATE~TIME 
G2 FILLER 


G2 FHeUSER-INFO 

02 FHeSAVE.FACTOR © 

O02  FHeCREATION.~DATE 
02 FH.ACCESS.DATE 

O02 FH.SER.NO | 

02 FHaMPF.ADDR 

a2 FILLER 

G2 FHeUPDATE.VERSION 


O02 FH»ADMSeHRITE eCONTROL> 
(03 FH.DMS.TO.BE.WRITTEN 
C3. FHaDMS.CONTROLPOINT 


02 FHeVERSION 

Gc FHePROTECTION 

Od FHePROTECTION.IO 
G2 FILLER 


G2 FHeAFEA. ADDRESS €105) 


03 FHeUAIT 
C4 FHePORT 
04 FReCHAN 
04 FH.SER.NO-FLAG 
04 FH.EU 
03 FH.ADDR 


The” B10c0 MCP. ‘newudes the 
over fore than one removable 


known as a "Multi~Pack File™ 
some Limitations on the use of such filese 
or cartridges 
remaved 
contained in the "B1700 Software Operstional Guide™. 


indiscriminately. 


which contain 
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BITC1499% LENGTH CF MYSELF IN SITS. 

BlYC4)s ~ | 
HAVE IT OPENED WITH LOCK 
BITC 203eZ% LENGTH IN BITS. 
BITC4)»2 DON'T USE TILL 1977 
BITCZ20) 92% 

WOFD>s 

WORD» 

BIT €12)> 

BI (12). 

WORT » 
BITC4)»2IDGN'T ie TIL 1977 
BITC 20) 52 | 
BITC24)52% DON'T USE TILL 1977... IGNORED 5.1. 
BITC3)59% HITHERTC =O. FOR RELEASE =1, 
BITC1) 5% HITHERTO 4 BITS. | 
BIT(C24)» 7 
BITC 16) 5% HITHERTO. QO. HENIGE"S GENEROSITY. 
BITC&)» 

WORD» 

BIT (€12)> 

BIT €16)>» 
BITC16) 22% | 
PITC24)522% DON'T REUSE TILL 1977. 5-1 IGNORE 
DSK2ADR» Z% DONT REUSE TILL 1977 
BITCids | 
BOCLEAN> 


BOOLEAN» 
BOOLEAN» 

BIIC36)>  «X YEAR eJDAY>TIME 
BIT (225% HOST RJE 
BIT (2)5% HOST RJE- 
BIT €16)»% HOST RJE- 

DSK.ADR> 

BII €12)> x 

BIT (3)> Zz 

BIT C4)> 2 

BOGLEAN» 2% 

BIT C4)» % 

BI1 €24)3 


capability to site a file to extend 
pack or cartridge. Such a file is. 
(MPF). Quite obviously» there are. 
The individual packs 
the file may not he 
cperational detaits are 


portions of. 
Various 


wen SR ate A Ae cine A i A pm Se en A ata te 
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BASE PACKS © 

A aulti-pack file may have only one "Base Pack" CBP). The name 
of the base pack 1s the pack id as sfecified ty the user in the 
FPB cf the multi-pack files The tase pack must be on Line for 


all OPENs of the file. The MCP may also require that the base 
pack te cnvmline for other operations» such as the assignment of a 
new area af disk to the file. An appropriate message witt be 
typed on the console printer by the MCP if the base pack is 
required and it is not on-line. The cperator may then mount the 
base pack and the requesting progras will continue. The base 
pack wust be cn Line when the file ts closed if it was opened for 
output or ape OU ED Hes | * yt 


A base eek may contain single filess as wetl as: nulti-pack — 
tiles» in any combination. It may nct» be a “continuation pack™ | 
for a multispack une whose base pack isa different physical — 


- pack cr cartridge. 


The file header for a aulti-pact ‘ine is. contained . on the base _ 


packs It contains all information ccncerning the. hee rot rae 
the addresses of every area assigred cn the hbase pack to that | 


file. For each arez whict resides on a continuation pack» the. 


header will contain the serial number of the continuation: packs — 


This allows the MCP to control att processing of the file and 
therety avoids the necessity. cf undatirg each continuation — pack — 


as the file 1s processed. 


CONTINUATION PACKS 


A multi-pack file may» by definitions reside cr two or more packs 


or cartridges. When the file overflows or “continues” to 


additional packs» the term “continuation pack” is usede A 
multitpack file may reside on up to sixteen packs or cartridges. 
There flay be up to fifteen contiruation packs assigned to one 


multi-pack file. 


A continuation pack may be associated with only one base pack. A 
gantiruation pack may contain only continuation filess it may 
met be a base pack for another file. A continuation pack may 
contain information associated with more than one nulti~pack : 
files» but all of the files must be essigned to the same base | 
packs as es ak re : my _ 
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The fite headers which ;is contained on the base pack for a 


multi-pack file» contains disk addresses for orly those areas of 
disk which are assiqned to the base facke The same statement can 
be mace of continutation packs» the file header contained on a 
contiruation ecack contains disk égcdresses that are assigned on 
that pack only. The file header on the base pack contains’ the 
serial number of the appropriate ccntinuation pack in the disk 
address fields of the headers. . 


When « file overflows from the base pack» the MCP will search for 
another continuation pack that is already on-line and that is 
assoctated with the same base pack. If such a continuation pack 
is ffeund» the file automatically cverflows to that continuation 
packe If no such continuation pack is present on the systems the 
MCP will then search for a scratch péeck» one which has no files 
on it» with the same type as the base pack. "Type”™ here means 
"restricted" or unrestricted" and is determined when the pack is 
initialized. | | 


If such a scratch pack is founds the file automatically continues | 


te that pack. If no such pack is founds the MCP temporarily 
halts the program and prints an éfpropriate message on _ the 
console printer. The program may be continued when a suitable 


contiruation pack is present on the systeme 


When 2 multi~pack file is opened inputs the file®s neader 1s read 

anto wemcry from the hase packe- Wher 4 multi~pack file is opened 
 Qutput» and news. a header is ccnstructecd in memory from 
information in the program's FPB ard information from the base 
packe During OPEN the MCP will find space on the system pack for 
a multirpack file information tattle» The table will contain 
specific information about the hase pack» alerg with an exact 
copy of the disk file header from the base pack. This copy of 
the header is treated as a working ccpy while the file is open. 
The header on the base oack may therefcre not always be correct. 


The format of the MPF.INFO.TABLE is presented betow. One 
MPFoINFOSTABLE per file is required» regarditess of the number of 
 userse | | ES | | | | a 


STEM Setar) rue ee ence rer oe 
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FIELD (NAME TYPE 


MPFSINFO.TAELE 8=—--:1392 BITS. 
MPF eFORWARL 36 BITS 
MPF .BACKWARD | 46 BITS 
MPF. SELF 26 BITS 
MPF NAME 30 CHAR 
MPF HEADER. SIZE 24 BITS 
MPFeHEADER- ADDRESS 246 BITS 
MPF.BPS.NO 2h BITS 
MPF.OPEN.TYFE 4 BITS 
MPFONEW.FILE an 1 BIT 
MPF.NEW-AREA 4 BIT 
MPFLCS : aLT 
FILLER oe | 1 alt 
MPE.BASE*PACK. TYPE 4 BITS 
MPF ARRAY 
MPF eONLINE | | | 
C4 MPF.SERIAL.NO 24 BITS 
04 MPFHDR.DSK 36 BITS 
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DESCRIPTION 


POINTER TO NEXT MPF TABLE. 
POINTER TO PREVIOUS MPF TASLE. 
POINTER TO THIS MPF TABLE. 
FILE“TDENTIFIER. 


SIZE OF COMPOSTTE HEADER 


MAINTAINED BY THE MCP. 

POINTER TO THE COMPOSITE HEADER 
IN MEMORY. 

BASE PACK CBP) SERIAL NUMBER. 
TYPE OF FILE OPENED. SAME AS 
CFHeOPEN.TYPE IN DISK FILE HEADER. 
MCP FLAG USED IF THIS IS A NEW 
FILE. 

MCP FLAG USED IF NEM AREA WAS 
ADDED. | | | 
MCP FLAG TO MARK IF CLEAR/START 


~WAS PERFORMED SINCE THIS Enel: 


WAS CREATED. 


IYPE OF PACK USED AS BP. 
1=RESTRICTED» 2=UNRESTRICTED 
USED TO RECORD ALL PACKS THAT 
ARE ONLINE. 

MAXIMUM CF 16 ITEMS IN ARRAY. 
SERIAL NUMBER OF THE PACK. 
DISK ADDRESS OF THE FILE HEADER 
ON THE PACK. 


MULTI-PACK FILE GENERAL RESTRICTIONS 


acdition to any restrictions listed in the foregcings the 
items belcw are also apolicable te multiw~pack files. 


Since a system cartridge may not be a base packe 
cr systems with two or more 


files are only 
cri VES « — 


operational 


multimpack 


att packs  Conesieins any. part of a multi~pack file must have 


unique serial. numbers. | 


ae 
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PRINIER FILES 


ALL @urrcughs printers and controls have hardware capability of 


spacirg the paper after writing a Line of output but no 
capability of spacing the paper betore writing the line. With 
the advent of the ANSI "74 COBOL Larcuage in the 9.9 version of 
the software» the need for a more efficient means of performing 
the CCHOL WRITE AFTER ADVANCING statement became apparent. In 


prior versions» this operation was implemented by the compilers» 


generéeted two actual I1/9 communicate operators for each such 


statement ancountered. The first of the two was a Position 
commuricate or a WRITE of a Line of c-lankss the second was a 


WRITE of the actual record with no pzfer moticn specifieds This» 
of courses resulted in two communicéetes as well as two physicat 
IQs for every togicat WRITE AFTER ADVANCING operation. The 
change descrited below was first inaclewented in the 9.0 Operating 
Syste# and is included in atl subseouent versions. 


The goat of this wodification wes te recuce the number of 


communicate operations to one per tocical WRITE and to reduce the 
chysical I/0 operations to ane per commuricate operation using 
the existing crinter hardware. This was accowplished by delaying 
the initiation of the physical [70 operation until the fotllowing 
Logical wRITE is received. By krowirg both the previcus9 and 
current togicat [7/0 requestse a physicat I/0 can be initiated 
which ccrresponds tc the first request and takes advantage of the 


Burrcughs hardware. 


The diagram in Figure 1 shows the relationshio between the last 
logicel request issued by the user» the currert logical request 


and the actual ohysical I/0 operatior that wifl be performed. 


29S TE act, Et AE ST Be 
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Current\ Pending 
Logical \ Operation 


Request \ 


{ Null | Write» No Space Write Before. 
1 7 | 7 : Single Space 
free aan caletesteieatateteteted Selententeterietenlestatetetatetetetonter ee + 
Write» |  Notops | Write» No Space 1! Write» Space 1 1 
No Space | Fending?= #1} #£z»Pendirg?= 1 Pending:= i 
| | '  Write/No- i Write/No ff Write/No | 
; | OO ee Sttetetetetet telat ttt ween ant 
Write/B ft No-op» t Writes No Space { Write/B Space 1 | 
Space 1 1 Pending:= 1 Pendircs= | 1 Pending:= | 1 


I Write/8 Space 1 ! Write/B Space 1 1! Write/B Space 1 1 
Write/B 1! Write/B Space 2 I Writes No Space 1! Write/S Space 1. 
Space 2 1. Pending?=Null | Write/8 Space 2 1! Write/B Space 2 t 


i in t. Pendire==Null f Pending:=Nult 1 

frown eee mene fume ec aeenaenee fone ee ene + 

yirite/A | Space 1  t Write/® Space 4 il Write/8 Space 2 | 
Space 1 ! Pending:= 1 Pendirg?= i Pending:= ] 
| | Writes No Space I Write» ho Space | Writes No Space 1 
freee me olehatetanion fmeeaee Relea lett ealeteel Token elena tetas Ss aketetent 

Write/A_ | Space 2 [| Write/B Space 2 1 Write/&. Space 2 ! 
space 2 | Pendings= #4| Pendirgs=_ i Space 1 i 
oo Io Writes No Space f Write» Ne Space I Pending?= i 
1 i 1 drite» No Space ! 
peewee nme nme meme panna leeKaliatie te leeleetaatabented Aolenteieteator elateetesladioeteatetedete 


wWrite/sB | wWrite/8 Channel ! Writes hea space ! Write/B Space 117 
Channel ¥ Pending:=Nullt J Write/B Channet f Write/B Channet 1 


i 3 —) Pendirct=Nutl 1! Pending: idee 1 

a Petes ewer eeoee leaded Seka detente ke teakatetetedated Leleatetetetonettetetentetatetateton + 
~Write/A 1 Space Channel 1 Write/® Channel 1! Writes Sac. it 
Channel 1 Pending:= ! Pendirgs= | Space Channet 1 
a 1 Write», No Space ! Writer Ke Space ! Pending:= 1 

i | | ff Writes No Space I 

| Sota leatetettaleale etalk tekekeletetataiekatakatatetakelaked tetoletetebetaiedatelekeketentetelen +‘ 
Space N 1 Space x i Write/3 Space x I Write/B Space 2 ! 


| Space (N-x)? f Space CNwx)- if Space (N-1) mi 
— Pendirgs=Null § Pendirc?=Nuit ¢ Pendings=Null 1 


Figure 1 - Logical/Physical I/0 Relationship 


te the preceedirg diagram» the cperatiors within the table 


correspond to the actual physicai I/C operations that will be 
performed» which will depend upor the current togical request 
supplied by the user and eny operaticrs that are still pending 
. from the previous request. kKrite/B and Write/A may de read 
“Write Before™ and “Krite After". The symbol. (s=) may be read 
"is replaced by". It can be seen in the diagram that some 


logical requests witl» at times» result in two physical 
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~ operations being initiated. Under these conditions» it may be 


beneficial to supply each printer file with at least two buffers» 


“if the execution time of the program is the only concern. Total 


system throughput will not be impacted significantly regardless 


cf tre number of errinter buffers and the types of operations 


being performed. If the MCP must wait for the completion of any 
prirter physical 1/0 operations the time that 15 spent eens 
wilt ‘Ee masked by the PED Cess. tng. ct cther programs. 


Along these same lines» it should be remembered that any time a 
Write operation is teft pending arc control is returned to the 


users the MCP must have an avaitabte buffer to store the data 


that is to be written. If no buffer is availabler control may 
not be returned to the requesting user until a buffer becomes 
availeble. Again» this time witt he cverlanped with the 


processing of other programs and system throughput should not. he 
Significantly impacted. 


The action presented in the ereceeding chart for a Space 


operation requires some explanation. A Space of more than two 


lines must be hardled by the S.MCP. The Micro MCP will attemot 
to space the requested number of lines without calling the S.MCP, 
but this 1s not always possible. In the dtagram» when the 
Pendirg operation is equéel to Nuitl» the Micro MCP will space the 
paper one or two lines» indicated by “x™ in the diagram» and if 
N-x is greater than zero» it wikl fess the remainder to the 


SeMCP. Similarly» when the Pending cperation is equal to a Write 


with Ko Space» the Micro MCP will issue a Write/B Space 1 or 2 
lines» also irdicated by "x" in the ciagram» ard if the remainder 
is greater than zero» pass it te the S-MCP. When the Pending 
operation is a wWrite/B Space I>» the Micro MCP will tssue a 
Write/B Space 2 and pass N71 to the £.MCPs» if N-1 > Of 


LINAGE Cleuse 


The LINAGE clause» in ANSE "74 COBOL is a wmechanisa which allows 
the user to define a “Logical Page" format and request that the 
Operating System maintain printer fpeges which conform to the 
defined formate as well as a current line position on that 


blegicel pagee In the languages the user may specify the Logical 


Page size» an integer which represerts the number of Lines that 
may te printed on any page- This attribute will be known = as 
PAGE.SIZE in the remainder cf this discusion. = 


The user may also specify an Upper Mergins ar area at. the top of 


each fage where nothirge will be grirtec» Lower Margin» a simitar 


area at the bettom of each page» anc a Footing areas a speci fied 
number of lines in the page hody innediately ahove — the Lower 


Margin areas. The user gay also éesk to know the number of the 
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Line in the page body where the tast line of autput was printed. 
This requires that the Operating System maintain a line counter» 


which will be the number of Lines written or the current page. 


The inmplementation is called the “Locical Page" function in the 
Uperating System and it includes the following: 


1. Fasitioning to the beginning of the page tbody i.e. past the 
: top margin at OPEN or at page cverflow. 


2e Reporting End-of-Page when the user writes or spaces within 
the footing area and requests ECP renorting. | 


3. (Cetecting page overflow. Page overflow is defined as 
Gccurring whenever the executior cf a WRITE woutd leave the 
line counter positioned past the cage bocdye 


4e Updating the tlogical nage de escription when switching fron 
cne logical odage size tc another. 


Essentially» the implementation cbheys the rules presented in the 


ANST "74 COBCL specifications. The operating system will 
maintain a line counters a current logical page description and a 


new tloqicat age decription. The Line counter represents the 


position an the p2ge bady following the open or the last tlogical 
write. The current Logical page cescription is used to detect 
end “cf"™page anc page cverflow. The rew logical page description 
is used to initialize the current logical page description when 
page cverflow is detected and to calculate the Prumber of lines to 
the first Line of the next Oage Lady. | - : 


If the user has specified endcat"page reperting and the line 
counter is greater than or equal to the tine number at which the 
footing begins» then on completion cf the WRITE» EGP is reported 
tc the user. If the line counter wueuld be greater than the line 


~ nunbet dt which the bottom margin begins at the end of the 


logicel WRITES an implicit position te the first line of the next 
page body is generated according tc the before/after variant of 
the write statement» At this point the Line ccunter will be set 


te J- The numter of Lines to skip is. calculated according to the 


foltawing formula: 


neccvonsere = current.epageebcdyesize = Lineecounter + 
current.bott OM paras Size + newWetope marginesizes 
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The Legical Pace descrintion is ucdatec if necessary when a write 


occurs that causes wage overflow or whenever an advance to top of 


page Cccurse 


ic access the tine ccunter reauires <~ File Attribute Communicate 
from the user program. This will be of no concern to ANSI "74 
COBOL users? they need only be concerned with the proper syntax 
in that Language for referencing the Line ccunter. The Logical 
Page detinition is changed to the values included in the write 
Commuricate fermat whenever nage cverflow is detected. To 
acconcdate the above requirementsSr the format had to be expanded 
as shcwn in Ficure 2 in the WRITE AFTER ADVANCING section of this 


document cresented previously. 


The Legical Pace imetlementation»s since it 15 implemented entirely 
in scftwares is usejdle even when the file is directed to a 
Backup wedium. © The Logicat Page implementation is also useable 


by programs that are written in languages cther than ANSI '74 


COBOL. This is effected by the iaplementation of additional 
syntax an cre FILE Controt Card. Progarms may be permanently 
mcdified to incorporate the required rew attributese The Logical 
Page function is activated hy the PACE.~SIZE attribute in the File 
Parameter Block. When a printer file ts opened and PAGE.SIZE 


contains @ value cther than zero» péegqe format wilt be controtleda 
by the Logical Page software taplerentation and the physical 
carriage cantrot tare oan the device will te completely ignored 


after. the file is COpene 


It is importart to note that the Charrel One punch» as welt as 


the Channel Iwetve punch in the carriage control tape is ignored 


after the file is open. Accorcing to ANSI "74 COBAL 
specifications» this 1s 4s it shoulc be but it dictates that the 
attritutes which govern logical page format must be specified 
such that the togical page size clus the upper margin plus the 
Lower margin must total the axact nuaber of tines on the physical 
pagee If this is not done» then eventually at least» tines will 


be printed on the crezse between the fhysical pages. 
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The relevant attributes may be refererced in the FILE Controt 
Card as shown betow.e 


Attribute Abbreviation functior 
- PAGE. SIZE P.eS. The numter of tines between the 
: 3 Upper Méergin and the Lower Margin. — 
May be set to any value between 1 


and 255 inclusive. 


LOWER.-MARGIN ~ LM The number of lires from the page 
a rt body te the bottcm of the form. 
| | _ 8 | May te set to any value between 
y : 0 and 255 inclusive. 


UPPER eMARGIN U.M Tne number of tines from the bottom 
| | Cor top) of the fcrm to the page body. 
| : May be set to any vaiue between 
| 7 SS 9 and 255 inclusive. 


FOOTING FOOT The nugter of tires from the. 
| 3 - teginning of the page body» 
Within Page.esizes» to the point 
| oo where the MCP will begin to 
| 7 report enc-of~page to the usere 
ee a May be set to any vatue between 
| =< 3 | | | 1 and 255 inclusive. 


ae aim wee a one a on <b a he cD 


egINiti ANC PUNCH BACKUP CAPABILIIIE 


The CP includes the capability of cirecting the output data for 
printer and purch files to intermediézte storage. The storage 
mediums @ayr at # the user*s optior» be magnetic tape or diske 
Backup files way not te directed to céssette cr flexidisk media. 
oe utility routines named SYSTEM/BACKUPs its provided to attlow 
| users. to retrieve the output data frem the intermediate storage 
mediun. Fer details on this rcutines refer to Product 
Specification 2222 2681» System Backup. 


when the output is dieacead to magnetic tape» multi-file tapes 
are created untess the operator intervenes in some manner. If 
the operator dces not intervenes the tape will be closed with no 
rewind when the printer or punch file is closed in the program. 
“The next ‘printer or punch file which is opened by any executing 
program and cela eies tape stcrage will then be added to 
the existing tape This process wild continue until the operator 
intervenes or nti t: the physical end of the tape reel. is reached. 
Opersétor intervention procedures are described in the Softuare 
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Operational Guide and in the wEP Control Syntax Product 
specification. . | 7 | 


When. the output data is directed to irtermediate storage on disk» 
it ts entered in the Disk Directcry when the printer or punch 
file in the program is closedj At that time» it may be accessed 


by ary programs though the daté contained therein may be 
undecipherable unless the accessing frogram is written expressly 
for this purpcse. The file Bay not» under ary circumstances» be 


accessed prior to the time the file is closed. 


BACKLE EILE sLockING EAcrORS 


The QFEN routine in the MCP attempts to optimize the size of the 


physical blocks associated with a Bzeckup file» according to the 
dectared size of the Logical records in the files . The block will 
typically be set to a size equivalent tc three or four disk 
sectors» each af 180 bytes» by the ¥CP. In order to predict the 
block size that the MCP will select for any given togical record 
$ize» it iS necessary to consider the controt information that 


the MCP stores in the first physical block of the file as wett as 
the declared record size. The algerithm that ts used by the MCP 


to select a tlock size is not easily cescribec. The block size 
which as selected is stored in the file Label» for tape fites» 
and in the Disk File Header for disk files. The Logical record 

Size is also stored ir these fields. | a 


Consecuently» using ‘the Default File Attribute> which 1S 


described in the Software Operatiorai Guide and in ancther part 


of this specification» the user may access JBdackup files without 
knowirg the blocking factor and lecical record size in advance. 
Since the algorithm that is used by the MCP to calculate block 
stze Bay change from version te versions $this tweans of 


deteragining the blocking factor usec is preferred. The algorithm 


that is included in the 8.9 version of the MCP is described in 
the paragraphs that follow. | 


The togical record size declared in a file in a user's prograns 
Way be any size. If the file is directed to Backup storages it 
is set to a maximum of 132 bytes. the logical record size is 


then incremented by two bytes. This additional sixteen bits of 


information is necessary to contain the formatting information 
which is passed with each Write and Pesition communicate 


- operator. 


If. the file is being divecess to daonetse tapes the record size 
ais then irncrementeds if necessarys tc force it to a number which 


ds meculo. forty-eight~ This is necessary sirce seven-track tape 
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units require biock sizes which are scdulo six and phase~encoded 
drives require block sizes which are madulo sixteen. It would. 
not te sufficiert to insure that only bleck sizes meet this 
requirement» howevers since the blocks on any tape file may” be 
nee tlocks which contain one or acre records. 


Yhe buffer size will always be made iaeas erough to contain 100 
bits cf control informaticn plus 1668 bits to contain the 
origiral File Parameter Block as it ‘appeared in the user's 

programs plus» if the file is a printer file» 1072 bits to 
contain a file Llahel glus its associéted spacing information. If 
the original file is a punch tiles a space of 648 bits is 
reserved for the label instead cf 1072. . The one fact which 
complicates this calculation is that att three of the items 
listec above must begin on a Logicat record boundary within the 
physical block. Conseauertly» for &@ file with a declared record 
size of 132 tytes» which is converted to 134 bytes or 1072 bits 


by the OPEN routine» the FP3 will teaqin on the 1073rd bit in the 


first physical block of the file. The file label» if there is 
ones will becin on the 3217th bit (2 x 1072). #£#The first outout 
Gata reccrd will then begin on the 428Sth bit. The block wilt be 
made large encugh to insure that the first block contains at 
least one Logicat record in additicn to all of the information 
listed above. | 


For backup files which are directed to interswediate storage on 
disk» the clock size computed atave is then increnenteds> iif 
necessary» tc make the size module 1440. The number of records 
per tlock is then computed from record size and block size. 
-End-cf-File is never reported to 4 user program when.a Backup 
file is being createde The mCP automatically closes the file 
when it is full and also automatically opens a new Backup’ file. 
The identifier assigned to the second file will revert to the 
standard namirc convention for Backup files» | The MFID wilt te 
set to BACKUP.PRT and the I0 fietd wiil be set to the next 
sequential number maintained by the system. Alt other ®ackup 
file ettributes» such as the number cf copies reauested» wilt be 
retaired in the second and subsequent files». Only the name 
requested by the: Userswett he Lost. _ —_ 


The CP alse allows users to epeecty the file attributes Blocks 
per Area CBLOCKS.AREA or 8-A)» Recerds per Block CRECORDS»}BLOCK 
or ReE)» and Number of Areas CAREAS cr ARE) fer printer files and 
these specified values will override the system's default values 


fer the same attritutes. Using the proper setting of these 


~walues . and the auto@gatic closing and reopening described in_ the 


preceeding paragraoh» users may tegin printing a Backup file 


while the program which created it is still executing and 
fepeeting fue second or subsequent portion of the Same. file. | 
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Recorcs in Printer files may not pe tlocked. sciicticesias the 


Records per Block attribute is not applicable when the file is 
directed to the printer. Records per Block is utilized only when 
the file is directed to a %ackup w#edium. Also» the value 
specified for Records per 8tlock must be greater than a mininuan 
value» which is.a function of the record size associated with the 
file and which is computed by the MCP when the file is opened. 
It is reccomended that users not set Records per Block = for 
Printer files in the use of this facility but establish the file 
size via the Blocks per Area and Numter of Areas attributes only. 
For a file with 132-byte records» fecords per Block will be set 
to five by the MCP unless overridden ty the user. The simplest 
means of determining the value that will be computed for Records 
per &tock by the MCP for any other given record size is to direct 
such aéefile to the backup medius and interrogate Records per 
Block. | | 


The MCP insures that access to a backup file is in serial mode 


only. If the user had requested fore than two buffers on the 
crigiral file» the number 1s reducec to two cn the backup tile. 
In .a similar manner>e the MCP Liaits the number of disk areas 


requested to 25-6 The file type in the original FPB is’ then 
changed to indicate that the file was directed to disk or tape 
intermediate storagee- 3 , | 


BACKUP FILE CONTROL INEQRMATION 


The first block in any hackup file is filled almost entirely with 
control information. This information is used by SYSTEM/BACKUP 


when the file is printed or punched. The first twenty~four bits 
of the block wilt contain the Legicél recorg size» in bits» as 
computed by the pricr portion of the QPEN routine. The next sx 


bits cof.the tlock wil contain the rumber of tits that the record 
Size was incremented to make it modulo forty~eight» if the backup 
medius was magretic tapee- If the béeckup medium was disk» these. 
six bits will be equal to zero. The rext eighteen bits specify 
the control information size» in bits. This field will contain 
the number of bits which gre used ir the first block of the file 
to centain the control informaticns exclusive of the File 
Parameter Block and the label. In the 9-0 version of the MCP» 
this number wilt be equal to 100» aithough allt of the 100 bits 
May not be usede | | 


The next twenty"four bits of the block will specify the FPB sizes 
in bitse This number may vary fror release to release. For the © 
9.0 version of the software» the FPE size is 1668 bits. The next 
twenty-four tits will contain the size of the Labet» if any» 
associated with the printer or punch files This field will 
always contain these values» regardiess of whether the file: as 
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Labeled cr not. The next four bits will centain a number which 


specifies the type cf label that is ccntained in the label area. 
“In atl céses» at the present time» this nuster will be either 
zero» indicating a standard tabel» cr one» indicating that the 


oVte is untabelled. 


Unless the computed Logical record size of the file is exarttly 
equal tc the size of the control irformation listed aboves» 100 
bits for the @.0 version of the MCP» a filler will be added after 
the controt information.»  fhis filler will be of a size 
sufficient to make the next field in the first hlock» the FP8._ 


begin on a togical record boundary. Fer examples if the original 


Logical record size was 122 bytes ana the backup medium was disk» 
the filler would consist af 964 bits. 


The rext. field in the first bhkeck of the file will be the 
origirat File Parameter Alock as it éenpeared in the user  progras 
and tefore any changes were made cy the CPEN routinee Onty 
pertirent informations delimited by the size specified by 
FPBeSIZE wiit be included. Follenirg the FPB» another filler 
will probably be required to make the next field in the first 


block» the original fite Label» begin cna togicat record 
boundery. | | 


Actually» sixteen bits of spacirg irfcrmatior precedes the _ file 
labels the seecing information thus begins on the logical record 
boundarye For the Label» alt of the sixteen bits will be set to 
zerage. These sixteen bits wilt he fcltcwed ty the tabels» which is 


-censtructed exactly as if the fite had been directed to its 


intended mediur originally. The Latel is always constructed and 
storec in the fackup file» regarcless of whether the original 


file was Labelled or note. SYSTEM/BACKUP may or may not cause the 


Label to te printed cr punched» deperding upor whether the file 
was cr was not tabelled. The tabet in the first block witt be 


followed by a fillers if necessary» to allow the first logical | 
record of outout data to begin ona tlogicat record boundary 


Within the black. The first block wilt always contain at least 
one dcegiceat outout record. | , | 


BACKUP FILE LOGICAL RECORD FORMAT 


Each iogical record in the file will copes tat sixteen bits of 
formatting informaticn followed ty the user’s output data» 


unatitered.- If the Logical recorc was generated by a Position 


commuricate operator,» the contents of the data field are. 


undefined and are ignored Ly SYSTEM/BACKUP. The sixteen bits are 
eyed as follows. a eg eer 
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Beginning with the 9.0 version of the softwares the sixteen bits 
of carriage cortrol information are subdivided as? | 


01 CARRIAGE CONTROL - | BIT (16)> 


02 FILLER | BIT €3)» 
G2 BEFORE_AFTER aa BIT (ids. 
O2 CHANNEL_CR_SPACING BIT (€8)> 
02 1YPE BIT (€4)3 


In the descricrtion abdcves» the SEFORE_AFTER field is applicable on 
WRITE operations which are directed tc a printer file... A one in 
this bit position indicates the operatior was WRITE. AFTER 
ADVANCING. The CHANNEL_OR_SPACING field corresponds to the eight 
bits of spacing information passed cr a WRITE communicate in the 
CT»~ADVERH field in the communicate cferator. These bits are 
defired in the Oeward Management section of this documents but 
the definition is repeated here for reference. 


 CHANNEL_OR_ SPACING 

0000 ~ No paper motion | 
CO01l ~- Skir to Channel Qnre 
0G02 —- Skip to Channel Iwe 


mou on 


101i ~- Skip to Channet Eleven 

1100 - Skip to Channel Twelve 

1101 - Skip to first tine cf the fors C1500 LPM 
printer only) . 

1110 - Single space 

1111 7 Couble space 


hou Wh 


Weoal 


The TYPE field in the descrintion prevides information on the 
type of communicate issued by the user or this record. The 
CARREAGE_CR_SPACING vatue wilt have cifferent meanings» depending 
upon the value of the TYPE field. Tre correspondense between the 
two is shown below. | : 


TYPE Operation CARRIAGE_CR SPACING Value 


~~ ©0000 WRITE | Printer Channel Number | 
0001 WRITE Punch Stacker Nueber | 
C010 — “SPACE Number cf Records to Position 
0011 «SPACE Printer Channel Number on Position 


C100 WRITE © Printer Spacing Information 
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‘A Relative file consists of records which are identified hy 


relative record numbers. The file aay be thought of as composed 


of a serial string of areas» each capable of holding a _ togicat 


record. Each of these areas is dencminated by a relative record 
number. For example» the tenth reccrd is the one addressed by 
the relative record number 10 and is in the tenth record areas 
whether or not records have been written in the first through the 
ninth record area. Relative files are implemented using direct 
filese _ < | 


Direct Ejdes 


Direct 1s the primitive tite organizétion. A direct file is 
diviaqed into 2 number of “record stots" of fixed Length» each of. 
which may contain cne record. A reccrd stot is “empty™ if it 
contains no vélid record. Futl recore slots may be made empty by 
deleting the record they contair» making the contents 
unaccessable through the normal sanechanism. Since alt bit 
patterns are potentially meaningful as data» a-separate area in 
each block cf the file is mairtaired to indicate which record 
slots within that block have bean usec. There will be one == such 


"Presence Bit™ for each record stot in that block and the bit 


vector thus formed is known as the Glock Control Information 
CBCI). The user is not altowec to have access to the Block 
Contret Information under normal circumstances. 


Relative Fite Data Structure 


The Relative file is a direct file. ‘The blocks of the Relative 


file contain S8lock Controt Inforgation (BCI) as well as data 
recorcse The number of data records in a bleck is conatined in 
the “Recards per Block" field cf the disk file header in the case 


of an existing file. Originally» cf courses this number 1s 
specified by the user programmer ir his Fite Declaration. The 
data records will be Located on byte becundaries to conform with 


the eddressing capabilities of the £1000 Interpreters. The BCI 


will therefore be padded with zeroes tc insure thise When a 
Relative file is originally created» ait of the record slots are 


ampty. Consequently» the preserce tits in the BCI must be 
initialized when the area is aittlocatec. ied a 
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Relative File Disk Initialization 


The use of presence bits to tndicate that a record has been 
written into ar available record silct neans that disk areas that 
are atlocatecd to a Relative file vust be iritialized when they 
are allocated. All presence bits in the  S8tock Control 


Inforgation must ke set to zero at this time. 


when a disk area is required» the YCP will be responsible for 
allocating the areare and wilt éelso te responsible for 
initializing presence bits. If the access mode of the file is 
sequertial» the MCP just allocates the area ard the Logicat 1/0 
routires witt initialize each block Eefecre accessing it. If the 
access mode is random or dynamic» the MCP wilt initialize the 
entire area teing allocated ty autcnatically executing a special 
initialization program which will rur at the user®s priority. 
The user will have the option of executing this program himself» 
prior to executing the onrogram which accesses the _ fites to 
initialize the entire file or any areas he choses. In the 
seauertial mode» if the file ts clased with the EGF oointer not. 
at the end of an area» the MCP will initialize the remainder of 
that area. | ~ 


The program which initializes newly allocated disk areas for 


Relative files is called SYSTEM/REL-INIT. Tf this orogram is 


called automatically by the MCP as described above» the prograr 
which requested the new disk area will not be allowed to execute 
until SYSTEM/RELSINTT has completed the initialization of the new 
area. 


Relative File Parameter Glocks CEP8s) 


The FPE for a relative file is the same as for a Conventional 
randot file except that FP8.~ACCESS is set to a vatue of 20 


indicating Relative organization. 


Relative Disk File Headers (DFHs) 


The CFH for ai relative fite is the same as for a Conventional 
file except that the block size fielc will include the size of 


the block control information. 
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Relative Eile Inforaation Blocks CEIEs) 


The FIB for ae retative file is the same as for a Conventional 
randon file» except that a field which identifies the file as 
being Relative has been added. The field is named the 
FIB.CRGANIZATICN field and can assuwe values of zero» indicating 
a Conventional or ANSI "74 Sequential file» one» indicating a 
Relative file» and twore indicating ar Indexed Sequential file... 


Buffers for Relative files will be the same as_ for Conventional 
files. They will be allocated when the file is opened with one 


I/O descriptor for each buffer and the buffer size equal to the 


block sizes which is equal to the record size times the number of 
records per blecck plus the size of the block eae information 
C1 bit/record made ncdulo eight). | : | 


Buffer wanagement for Relative files will depend on the user's 


access method ~ Sequertial» Random or Dynamic. For Random access 
the management of the buffers will be the same as that for 


Convertional random files. REAG operations will be initiated on 


demanc and WRITE operations will be initiatec immediately after 
the tlcgical I/0 operation has occurred. If the access wmode is 
sequertial» the buffer managewent witl be the same as that for 
Conventtonal seriat files. The Oper procedure will fill all of 
the tcuffers end the Operating System will try to stay ahead of 
the user program» initiating physical Read operations when the 


fast logical record in a buffer has teen delivered to a user and 


initieting physical Write cperatians nen the last Logical record 
of the buffer is received. 


‘The Cynamic access mode in ANSI *74 COBOL attows the user to 


Switch between the Random and Sequential modes. In the Dynamic 
access made» wher switching from Secuential tc Randoms the last. 
block is written to disk if it has keen updated. when switching 
from Random to Sequential» the S¥YCP is catled on to filt the 
buffers as if en OPEN or Position hac occurred. In the Dynamic 


access mode» the access mode desired» Random or Sequential» must 


be specified in the communicate cperator .generated by each 
logical READ operation. a : 


Relative File Communicate Qnuerators 


Three new communicate operations» correspcnding to the verbs 
DELETE» START and REWRITE have been acded to the 9.0 Operating 
Systeme. To simplify the implementation and to avoid potentiat 
file ecuivalence precblems» new ccmmunicate operations for 


relative files have been added to the softwares rather than 


modifying an existing ersten The READ» WRITE and — REWRITE 


il 
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commuricate cperators have a format which is simitar to the 


format for the READ» WRITE and REWRITE commuricate formats — for 


convertionat§ ftites. The formet ter the DELETE operations on 


Relative files» is similar to the fermat for the sage operation 
on Irdexed Secuential files. The ANST *74 COBOL START verb has 
been imptemented as a new communicate and is handled by the Micro 


MCP. 
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Indexed jJeguential Files 


Indexed Sequertiat files consist of twec new primitive file types: 


Direct files and Index files. For each Indexed Sequential § fite. 
there ts one and onty one data file and this file is tmrplemented 
as a Cirect file. For ezch key of the Indexed Sequential file 
there is a corresponding file of type “index. In the MCP codes 


these two types are listed as INCEX.-SEQ.CATA.SET.FILE |. and 
INDEXeSEQeINDEX.FILE>S they will be refferred to as Direct files 
and Irdex files ir this document. 


Direct Files. 


Direct files were discussed in the cocumentation on Relative 


files. A portion of that discussion is repeated here for 
converierncee More details wilt he found in the preceeding 
discussione A Direct file is é primitive file tyoe that its 


divided into a number of “record slots" of fixed length» each of 
which may centain one record. A record sict is “empty” if it 
contains no valid record. Full record slots may be made empty by 
deleting the records they contain» taking the contents of that 


stot inaccessable by the normat aechanism. © Since all bit 


patterns are potentially mneanincful as a records a bit flag is 
maintzined for each record slot to show the validity of its 


Since atl record = slots are the same size CMAXRECSIZE) the 


absolute disk address can be easily calculated from the record 
slot number. The file is dividec into arcurs of record slots 
callec “tlocks"» each consisting of “blocking factor™ record 
stots plus the "Block Control Information"» a bit mask which 
indicates the presence of a valid recerd plus enough filler bits 
to make the container modulo eicht.~ . There is a significant 
difference between the Slock Control Inforwation for a Direct 


file and an Incex file» however. 
Index Files 


An Irdex file is the second new file type. Index files contain 


fixed Length records organized in tables with Block Control 
Intorgation to describe the table. Each black of an Index fite 


will constitue a separate tablee The importance of this fact 
wilt ce explained Later. . ot a rr 
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The records in the Index file consist cf Kev dGdrees pairsSe The 
addresses point to other tables in the Index file or to records 
of the Index Senuential title's data tile» the Direct file. The 


tables in the Index file form a tree structure and the records in 
the table are ordered by Key value to atlow fast randcem accesse 
The tables whcse entries point tc data records are linked 
tegether to allow fast sequential accesSe — | 


Cluster Files 


In addition to these two new file types» there must reside» 
somewhere on disk» information retating alt of the various files 


which compose an Indexed Sequential file. This information 15 


maintzineds ty the MCP» in a third rew structure which will be a 
separate conventional file on disk and which will be known as a 
"Cluster™ file. The name of the Cluster file will correspond to 
the user"®s declared name for his Indexed Sequential file. In the 


MCP code» this file type 5s referred to as an 


INGEXsSEQeGLOFAL.FILE» though it will he catled merely a Cluster 
tile in this document. | | | 


The Cluster fite provides the ability to’ reference the entire 
Indexed ‘Sequentiat file structure Ey -si#aply referencing the 
Cluster file. When the Compilers gererate code which applies to 
Indexed Sequertialt files» they actuaily reference the Cluster 
file. The Cluster file will contair the names of the other files 
associated with the ‘Indexed Sequertial file. As mentioned 
previcuslys — there will be one Index file. for each key Listed in 
the Indexed Secuential file 


The statement above does not mean that atl of the Index files 
will be opened when a Cluster file is cpenede The Index files 


are orly cpened when they are first referenced in the program and 
this actuality happens automaticatty. The compiters do _ not 
generéete code to open the Index files. The MCP simply detects 


that the referenced Index file has nct yet been opened» obtains — 
the mecessary information from the Cluster file» and opens the 
files. , , 4 | | | | 


The Cluster file does require an additional Disk File Header in 
memcrys but onty while an Indexed Seouertial file is being 
operec. It is not necessary for it tc be in aemory after the 
tile has been opened.» The Cluster file also adds an entry to the 
user’s disk directory. The diagras telow shows a Cluster file 
Schefaticatly. This particular fre has one prisarys. or *Prime™ 


“Wey ard one Algernate Keys 
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This crganization for Indexed Seauertial files offers several 


advantages over any other. Each file» the file which contains 
the actual data and all of the Index files» will have fixed. 
record ard block sizes. This wilt sirwolify the problem of 
managing the buffers that are assigned to the files- Both of. 
these file types are nothing mcre than Convertional files with 


some crder imposed upon the contents of the files. Consequently» 


the Cisk File Headers» or “File Descriptors” required for each 
file are the same as those for Conventional files. This. is 
discussed in more detail tater in the cocument. | | 


Cencectuatly» this mechanism is easier to visualize and implement 


than would be multiple structures residing in cne physical fite. 
Also» any of the files may be located on different spindles» 


which will clearly improve perforwances since arm movement time 
may be overlanped» and access to all of the files may occur 
asyrchronouslye The Direct file ard the Index file may be 


accessed independently of each other. © 


The destgn does impose certain restrictions» which fall in the 


categcry oaf “aperational™ restrictiors and which do nat impact 


pec formance. A checking mechanism is required to insure the 


integrity of files which are accessec indeperdently. The MCP 


must insure that the correct versicn of the Index file is used 


with its correspondine Direct file. Also» some extra memory for 
Disk File Headers wilt be reaquirece since more actual Headers 
will be required. A naming convention for all of the files must 


be tmposeds thus removing some secll amount of generality from 
the user's capabilities. This may <séctualty be an advantage» 


however. The naming convention is isplemented in the Compiler» 
“not ir the MCP» though this may not be apnag ern to» and should 
ocr be ‘isportant to the sere: | 7 
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The Cluster file is a Conventional data file which contains the 
information relating all the comoorert files of the Indexed 


~Sequertial file. The structure of the Cluster file is simitar to 


the ODéta Base Dictionary format in the Data Management Systen. 
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The CFHeEXTENSION and Structure Descriptor fields shown above are 


both discussed in the paragraphs that follow. The pointer shown 


above from the File Table is one of nmanye There is an entry for 


each fite ir the File Table and each entry has a pointer to its 
associated DEH. EXTENSION. 


‘Angaasd Sequential Data File Structure 


— data file cf an indexed Sequnediaat. file ts a Direct. file. 
The blocks of the data file contain Block Control Information 


CBCI) and date records» similar to the blocks of a Relative file 


as cresented previously. The number of data records in a block 
ais specified ty the Records per Stlock field of the disk file 
headers. A sitilar structure is used on Indexed Sequential files 


in the Data Management System. dtock Cantrot Information for the 
Index files associated with alt Indexed Sequential files is 
— significantly different from that for Relative files. | | 
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Indexsg Sequential In nde ex Eile Steucture 


Index files contain records corsisting of Key/Address pairs 
within a block. The file itself is a tree structure whose nodes 


are blocks. Fach block of the file is a node or table. The 


first node is the root table- The root table and tables on all 


levels except the Last are called coarse tables. The tables in 
the tast level of the tree are called fine tables. Entries in 
coarse tables point to the next level table whose highest. entry 


matches the key of the coarse table entry» © Fine table entries 


point to a record in the Cirect file whose key satches the _ fine. 


table entry CSee Figure 3). Fine tables are tinked together in 


lcgical order to oprcvide fast secuential access and easier 
Currert Recorc Pointer CCURRENT) mairtenance. | 


The eddresses in these tables are rot absclute disk addresses. 
Instead» they are thirtyctwo bit casbinations of an area nuaber> 
a segment number within the area anda displacement into the 
segmert. This disntacement is merely the record number within 
the block. All addressing of Index tables as wetl as of records 
in the data file is accomplished on <~ relative basis as orposed 
to an absolute one. | , | | 


The tlocks in Index files contain 8lcck Contrcl Information of a 
different content and format. © The format ard content of the 


Block Control Information maintained in an Index file is shown 
below. A similar structure exists fcr DMS Index files. 


(01 [NDEX.FILE BCI BIT (38), 


02 BC-1YPE | BIT (€2)e% O=COARSEs 1=FINE 
02 EC.PRESENT-RECORD-COUNT BIT C12), | 
02 EC.NEXT.~LOGICAL.BLOCK | BIT (24932 VALID FOR FINE TABLES 


The individual Kecords in the Index files. have a Fixed. fotmats | 
since the Key specified hy the user must be contained in these 


records» the size of the records may vary with the keys but the. 


format will alweys be as shown below. The sane format is used by 
the Deta Management System for recorcs in Index tables. 
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O1 INDEX-RECORD CECLARATION>% FOR DMS AND ANSI "74 INDEX FILES 


G2 IRSPOINTERs © 
C2 IR-AREA.DISP> | | a 
C4 IRsAREANMBR a  «BT1C8)» 


«04 TR SEGSNMBR a EI1(C16)>» | eS | 
O27 IR.OFFSET 4 * EIT(8)» Z VALID FOR FINE TABLES 
O02 IRKEY BITCKEY»SIZE); 


The organization of an Index file is stown in the diagram below. 
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_ Figure 27 Index File Organization 


‘This structure for the Indax files altcws the implementation —6COF: 


| the ost efficient search and adciticon algorithms. Linking the 
last tevel cf the fine tables tagether attows efficient 
-sequertial access of the records ir the data filee Using this — 


Links the CURRENT need orly point tc the last entry accessed in 


the fine tables and not to the gath through the coarse tables to 


the fine tables. This eliminates the need fer restrictions on 
the rumber of tevels allowed in order to maintain the CURRENT. 
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It also makes checking for changes ir the CURRENT» caused by 


other users accessing the file» easter. 


The File Parameter Glock C(FPB) cf the Cluster file of an Indexed 
Sequertiat file will be positioned ir the code file among the 
other FPEs according to the order of it*"s declaration in the 
user*s source code. In addition tc the tnformation normality 
contained in en FPA for a Conventioral file» a Cluster file FPSB 
will contain @ type field which idertifies it as a Cluster fite 
FPB» a pointer to the data file FPB and an integer which 
indicates the numter af keys associated with the Index Seauential 
file. There wilt be ona FP3 for eact Key declared and these FPBs 


will immediately follow the FP3 for the data file in the code 


file cf the program. This is shown ir the diagram in Figure 3. 


Gefault values are used for the file attributes of a Cluster 
file. The user way not change these values» © The number of disk 
areas will be set to one» records ger block will be set to onerp 
block size will ce set to 180 oytes eéerd blocks per area will te 
set te 5Ce The ALL»~AT-OPEN boolean will be setr causing the disk 
area to be allocated when the file is opened for the first timee 
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! | i 
1 PROGRAM PARAMETER 1 
i BLOCK : j 
4er~)FPSO.POCINTER | 
1 rn seraee eee 
j /f Mf 
i \\ SCRATCHPAD AREA N\A 
1 s/s COcE tt — | 
eo NN eh eS N@ FPBoFILE.TYPE =. BIT €8)»* 
Mali FPE Cfile Q) Cae 3: | | | 
ee Res ee eee I 2 3 7 - | 
j FPE CFile 1) | { / C2 FPSB.IS.SUB~FPSe~PTR B8ITC1Li2)>* 
ee eer Tee ee 1/ % number of FPBs displaced from 
! FPE CCLUSTER FILE) i | % the first FPB Cfite 0). 
ag, ee eer eer errr O2 FPB.IS.NUM.SUBSFPES GIT C8)># 
i 4/ a A Aan \ —CorC2 FPBEISNUM-ITO“DESC BIT €C6)-# 
i \\ REMAINING FPB*S — \\ | | 
I WEicccvici ieee gest 
#-—->1 FPS COATA FILE) 
{ | 
i FPE CKEY 2 1) is 
rae es en. iN 
{ FPS CKEY # 2) i \ \ 
Does eS ate iv 
tf : ti 01 KEY.~PARAMETERS» & 
VN : ONAN / C2 KEYeFLAGS» & 
oe ee ae /fof 03 KEY.PRIME : BIT C1ldee 
| FPA CKEY # Nd 1 | 03° KEY .DUP. ALLOWED BIT (1) 
a C2 KEY.CESCRIPTION> | 
03 KEY eOQFFSET i BI¥C16)e* 
03 KEY.SIZE BITCLi2)»* 
03. KEY.SIGNED BIT Cide* 
03 KEY-eDECENDING ~—6BIT h6C1 De 


* New field in 9.9 Software 


Figure 3 - Code Fite on Disk 


shbe. changes were also. necessary in the Program Parameter 


Bilock 


tn tre 9.9 softwares The chances are required to prevent 


programs which contain Relative ard Irdexed sequential files from 
being executed on versions of the MCPs released prior to the 900 


version. Further» program code files which are executed under 


control of the 9.0 “CP may no Longer ke executed under control of 


any prior MCPs. For this reason» users who anticipate returning 


to prior versions of the MCP are advisec to retain copies of. 
their coce files and to not execute these copies under contrat of 
the as 0 software. : | | 
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Generally» the memory structures usec if the Indexed Seouential 


implegwentation are much like the current Data “Management System 
memory structurese with but a few exceptions which take advantage 
of the more specific requirements of the ANSI "74 COBOL 
definition. Unlike OMS» which does not use File Information 
Slocks in memcry» Indexed Sequential files will have an FI8 
dictionary entry which will ogoirnt to an Indexed Sequential FI8. 
Qince the files way oe shared amrcrg the erograms that are 
executing» this FIW will contain orly the information pertinent 
to a specific user and witl be referred to as the User Specific 
a Oren tee CuUST) field. : : 


The ULSI witl contain a pointer to the file specific informations 
the airformaticn that relates only te the file itself regardless 
of whc is usire ite The certral element in this structure is the 
inforsatiton necessary to relate the vérious: component files of 
the Indexed Sequertial file. This is actually qlobat 
informations global to atl of the users» and will cortain a table 
whose entries point to inforwaticr specifically concerrirg the 
comporent fiie. The structure which contains this information is 
referred to as the Index File Structure Descriptor CSTR). #£There 
will be one Structure Descriptor for the data file and one for 
each Index file associated with the incexed Sequential file. 


otructure Descriptors contain pointers to the DFH»s Buffers and 
CURRENT information associated with the various Index files. The 
relationship cf the various memcery structures used is shown 
 diagramaticaily in Fiaoure 4. . , | 
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Figure 4° = [5s File Menory Structures 
FIB Dictionaries 


From the user's view points Indexed Sequential files are more 
like a Conventional Random file» except for the fact that 
symbolic key values ere used» than they are like DMS structures. 


Though the CUCata Management System is a superset of the Indexed | 
Sequertial implementation» the user is more tiketly to have 
several smalt and transient Irdexec Sequertial files. than one 
hare file which he would treat as a data bases 
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A seccndarys but importants» goal of the design of the ANSI '74 
COBOL iaplemertation was to alle» a smooth integration of 
Relative and Indexed Sequential files with the Conventionat file 
mecharisme For this reason and for cther reasons» access to an 
Indexed Sequentiat FIB is via the FIe Dictionary» which is atso 
used to access Conventional file FI8s. The FI8 for an Indexed 
Sequertial file is itself quite different from the FIB for a 
Conventional file. The Indexed Sequential file is associated 
with several chysical files» whereas the Conventional fite is 
associated with only one. AlSoO» more than one user may share the 
inforgations including the data buffers» of an Indexed sequential 
FIs a Conventional file FIB is used by only one usere If two 
users are accessing the same physical Conventionat fitlee each 
user will have his owr FIR. | | | | 


For these reasonse an Indexed Sequential FIB contains three major 
perts: | 


1. User Specific Information 
 @e File Gtlobat Information. 
32: Component File Specific [nforméetion 


The entry in the FIB8- dictionary corresponding to the Indexed 
Sequertial file points to the User Specific Information CUSI) of 
this Indexed Sequential FIB. _ 3 | 


Indexed Seguertial User Specific Infgrmation (USI) 


The USI contains information associated with one user only. The 
MCP must know how the user has opered the filer for example as 
INPUT» and how the user is accessing the file» such as 
~sequertially. This information is kept in the USI. User 
statistics» status and MCP workspace are also kept in this 
structuree Finally» there is a pcirter to the next part of the | 
Indexed Sequential FIB» the globat information associated with — 
the bhysicat file. | 4 oo a 
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v1 USER»SPECTIFIC. INFORMATIONS 


02 FID. COMVCN. PORTION | BITC 220)0% The first 

Q3 FIB.ROOLEANS © | BITC58)» Z% 220 bits of 
C4 FIB-OPEN | ss BITC1)» % USI are the 
04 FIB.-CLOSING | | SITC1)» %X% same as | 
04 FIB.OUTPUT | BITC1)» Z Conventional 
C4 FIB-~INPUT a BITC1)» % FIBs 

03 FIS.GRGANIZATION  -BITC4), £ 
2 1 = RELATIVE | ; | 
22: INDE XED/SEQUENTIAL 

O02 USTI.FIS>» | 

03 FIBAUST-NOT.FIRST~TIME. THRU BI TC1L)» 

O3 FIPLUSTALAST.OPeREAD rs 7 BITCL)» 

QO3 FIBLUSIT-CDUPLICATE ‘es BITC T 

03 FIBZUST.~MATCHeFOUND 3 BLT)» 

03 FIB.LST-UPDATE.FLASG | | - BITC1)» 

O03 FIR.UST~FIRST.PASS | | BITC1)» 

O3 FILLER BITC2)»> 

O3 FIS.UST~ACCESS~MODE : BITC4)» 

603 « «FIBLUST~JOB.-NUMBER  BITC24)» 

03 FIS.UST.~RECORDe-ADDRESS BITC 24D» 

OZ FIBLUSILKEYsPOINTER BITC 24)- — 

03 FIBeUSTe=COMMUNICATE WORKSPACES BITC616). 
04 FI&-USIT-BINARY.SEARCH. ARCUEMENTS EITCZ208)»> 
C4 FIBAUSIA~INTERFACE.-PADS | BITC 96)» 
04 FIBLUST~SAVEsSTATEsAREA ~BITC312)>» 

03 FIS.UST.GLOBALSPOINTER | BITC24)» — 

03 FIB.UST.CURRENT~STRUCTURE | AITC8» 

03 FISeLSTAHEACER | — PITC24)> © 


Indexed Seguentiat File Global Inforaggtion (GLOBALS) 


As shown in the above diagram» the first 220 bits of the User 
Specific Information are the same as the first 220 bits of an FIB 
for a Conventional file- The rest of the infcrmation can be seen 
to pe items that are peculiar te a specific user of the 
structuree It is information thet is necessary for Operating 
System storage of the “state"™ variables that may be required to 
pert ors a single apeceuren for this user. | | 


Included in this scouaiaiiiac is a peinter to the next portion of 
an Indexed Secuential FIB> the file €lobat information. This 
dnformations known as the GLOBALS field» contains information 


| about the various physical files which comprise an Indexed 


Sequertial tile. Its main functior. is to provide a path to the 


required files necessary to complete an 1/0 operation. AD 
seconcary furction is to store infcrmation ome to the nCOR eT 


reeaversial aes 
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The path to a particular component file is previded by a system 
descriptor contained in a table cf system descriptors. The first 
entry of the table points to the céta file. The remaining 


entries pcint to Index files» one tor each key declared? they 


appear in the crder cf the declaraticn of their corresponding 
keys» For any operation which specifies a key» the compiler wilt 
specify the key number» which will te. use as an index into this 
table. 7 . 


The aqlobat information consists of pointers to the chain of 1/0 
descriptors to be used for operations cn the Indexed Seauential 
data file» a count of users who are updating the files and Lock 


bits to support ANSI '74 COBOL's tile level tockout. Also 
contained in GLOBALS are the count and flag fields necessary to 


enforce the prcehibition or concurrent epaek es A programmatic 
description is shown below. | it 


O01 GLCBALS 
02 GLOS.VEFSTON.NUMBER | BIT(C8)» 
02 GLOB.NUMEER.OF.USERS BITCH)» 
02 GLOS.NUMEBER.OF.UPDATERS . BITCH)». 
(02 GLOB.DISK.COPY.ADDRESS OSK.ADR » 
02 GLOB.SIZE.IN.~BITS | , BITC1i6)>» 
02 GLOB.MEMORY. ADDRESS | —- s BITC24)». 
OZ GLOB.LOCK.3175 | RITC2)> 
02 GLOS.TO.DESC.CHAIN. ADDRESS | BITC 24)» 
O2 GLOB~MAX.STRUCTURE. NUMBER | BI1(8)» 
02 GLOB.FLAGS BIT(6)>» 
? 03 GLOB.OMS.FILE 3 | BITCL)» 
03 FILLER BITC4)» 
03 GLOB.WRITE. ERROR BITC 1)» | 7 | 
O02 GLOS.~CONCURRENT.INFO> Oo : % AT THIS DMS INFO AND 
03 GLOB.INUSE.COUNT BITC6)» % IS INFO ARE DIFFERENT 
03 GLOB.CONCURRENT.FLAGS» i. % TIL STR DIRECTORY 
04 GLOS.FILE~AVAIL | BIT(1)» | | 


| C4 GLOB.UPDATEsREQUIRED-OR-INPROC SITC(1)>» 
02 GLOB.STRUCTURE. DIRECTORY» | 
03 GLO. STRUCTURE. DESCRIPTOR SY.DESC» 


AtL oof the pointers to subsequent portions of the Indexed 
Sequertial structure» all of which are known as Structure 
Dascriptors» are contained in the GLCBALS fielde This simptifies 
the task of maintaining the structures and it allows the buffers 


to be shared among the various users. It adds one. level of 


7 indirection. to all accesses to the data of courses but this | 
enpeuse is small for the benefits ‘it ysebese | a 
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Indexed Sequential structures 


kept in the 


01 STRUCTURE_DESCRIPTOR>» 


G2 
v2 


AS shewn 
to the Disk File Headers 
last tevetl. 
infor@ation relating aimost 


the 


STReNUMBER 

STReTYPE 
STReUSERSCOUNT | 

STR «BUFF ERSLOCK 
STR»BUFFER.LIST «POINTER 
STR»RECCRDS.PER.BLOCK 
STR SEGMENTS »PER-SLOCK 
STR«RECORD.SIZE 

STR eBLOCK.SIZE 
STReBLOCKS «PER«AREA 
STReSEGSoPERSAREA 
STR«DFH-ADDRESS: 

FILLER 
STR«CURRENT-POINTER 
STR»FLAGS 

O3 STR»PRIME.KEY 


O3 STReECUPLICATES»ALLOWED - 


O03 STRe-SIMPLE.KEY 
03 FILLER 
STReSPLITFACTOR 
STReKEY.INFO» 
O05 STReNUMZER.OF.SUB.KEYS 
G3 STReSUBeKEVs 

04 STReITEM.OFFSET 

C4 STReITEM.~SIZE 

O04 STReITEM. SIGNED 

04 STReITEM-CESTENCING 


characteristics of the file. 


header» 


The 


necesséry key 
Structure Descrintor. 
the key within the data records» 
duplicates are allowed» and whether or net 
are all stored in the STR. 
below. | 


This structures 


accoancdate 
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is similar to an FI for 
all cf the User Specific Information is 
For the Index files of an 
information 


For exagpler the position of 


$1izepr 


BITC8)>» 
BITC4)> 
BITC6)» 
BITC2) » 
BITC 24)» 
BIT{12)>» 
BITCB)» 


BIT(C16)> 


BLITC16)» 
BITC16)»> 
BITC16)-» 


~BITC24)>» 


BITC16)» 
BIT(24)>» 


BIT(1)> 
BITC1)>» 
BIT(1)> 
BIT(S)> 
BITC12)> 


BITC)» 


BITC16)» 
BITC12)» 
BITC1)> 
BITC1)5 


in Figure 4» the Structure Cescriptor contains a pointer 
the MCP-defined structure which 
as it always has» 
exclusively | | 
Any Logical information in the 
such as recerd size and rececrds per block» 
from the program which originally created the file. 


format of the disk file header héc to be expanded in the 9.0 
version cf the software to | 


the 


a Conventional 


it ts the prime key 
A orocgrém@matic description is 


to 


was obtained 
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-tmplementation. Prior ta _ the creation of the 9.0 versions 


several pieces of information associated with OMS Data Y%ases» 
whick should have teen part af the OFH» were maintained 
separately due to a tack of available space in the then curent 
definition of the disk file header. These fields have also been 
incorporated in the new disk file header. The new format has 
been designed to prevent the occurrence of such problems in the 
futures whenever the need for new fielcs tn the DFH arises. | 


Disk File Header Extensions 


Some efficient means of available disk space waintenance had _ to 
be devised for Indexed Sequential files» To accomplish this» the 
necessary inforaation regarding the evzilable space is maintained 
tn the Cluster file as a data recorde When ar Indexed Sequential 
file is apeneds this information ts brought tnto memory”) and 
stored in a memory area which wil! iamediately follow the Disk 
File Feader for the data file. This area is known as the Disk. 
File teader Extension. 


indexed Sequertial Disk File Header Extension 


When the Indexed Sequential file is opened» the. information on 
the available space within the Direct files» atl of which space is 
not available as far as the system is concerned» is brought into 
memory and stored in the DFH Extension» The format of this 
infor@ation in memory is as shown belowe | 


O01 CFHAISeEXTENSION» 


G2 FILLER | | +BITC16)>» 


602 DFH.IS.EXTENSION.STZE | BITC16)> 
O2 DFHeTSeEXTENSION- VERSION — BITC36)s— 
02 DFHeTSe«NEXT.FREE-RECCRD | BITC32)>» 
O02 DFH-IS-NEXT.~FREE.~GLOCK | BITC32)>» 
O02 DFH~ITS-ROOT.TABLE | BITC24)>» 


O02 DFH.ISeUPDATE.FLAG | | BIT C13 
Indexed Sequential Available Space Allocation 


‘The Indexed Sequentiat file systea maintains two fields in the. 
DFHeEXTENSION cf each file which keep track cf available space 
withir the OCOirect file. | This évaitabtle space should not be 


confused with the available disk space that is maintained by re 
Systene Available soace in an Indexed Sequential file or in a 


Relative file means that a record has never been written into an. 
available record slot or that a record was” written at some time 


3-73 


BURROUGHS CORPORATION | COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP | : | 81000 mCP Tf 
SANTA BARBARA PLANT 7 Pa Se 2212 5462 CED 
Out was subsecuently and is now deleted. To the Systeme all of 


the space allocated to the file is tn use and none of it is 
available. : 


Beth of the available snace pointers shown aboves 


DFHAISsNEXTOFREE®RECORD and DFHAIS-NEXT»FREE*BLOCK» witl contain 


addresses of bhtocks which have available space@e The 
NEXT»FREE*RECORD pointer dees not actually pcint to a record but 
points to the block which contains the available record stot. 
Recorc stot allocation within a bleck is accomplished using the 
preserce bits in the Block Control Irfcrmation for that block. 


The DFHAIS.NEXT.FREEsBSLOCK field will contain the area and. block 
number of the next totatly available block at the logicat end of 
the file» The first disk area of the aqata file is atlocated when 


the file is first opened and the NEXT.~FREE-SLOCK field is set to | 


zero» a valid address» at that time. Also» when the file is 
first opened» the NEXT»~FREE-RECORD fietd is set to @FFFFFFFFQ. 
When the Micre MCP needs to add arecord to the file and the 
NEXT»FREE-RECCRD field contains @FFFFFFFFa>» it means that no 


recorcs are available in a block that. has already teen 


initialized. The altocation ust be acco#plished using the 
NEXTeFREE-BLOCK field. | 


The Micro MCP will then initialize the Presence Bits in the Block 


Contrcl Information of the block addressed by the NEXT.~FREE-BLOCK 
field» move the address which is in the NEXT.~FREE~RECORD field» 
in this case afFFFFFFFF2 to the first thirty*two bits of the tast 


record slot in the blocks move the eddress of this block to the 


NEXTeFREEeRECORD field and incremert the NEXT-FREE~BLOCK field. 
If the incremented value of the NEXT.~FREE»~BLOCK field causes this 
disk area to exceed the specified size of a disk area» AFFFFFFFFa 


will te stored in the NEXT.FREE~BLOCK field instead. The use of 


this value is discused in @ subsequert paragréphe 


The record which is being added is then moved to the first record 


stot in the newly allocated blocks the oresence bit for this slot 


is set and the block is writter. The presence bits for the 
second and all subsequent record slots within that block will be 
get tc zeros due to the initiatizaticn processe a@FFFFFFFFas the 
value that was previously in the NEXT»FREE-RECORD field» wiil be 
stored in the first thirty-two bits of the Last record slot in 
the tlock. 7 } | 


When the next record is added to the files. the Micro MCP will 


again examine the NEXT-FREE-RECORD field and it wilt now contain 


the address of the block that was just allocated. The Micro MCP 


wilt read the block into memory» if necessary» and examine the. 
Presence Bits in the Block Controt Information. The first — 
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available record stot will be the second stot within the block. 
The Presence Bit for this stot will be set and» if this is the 


last record slot in the tlocks» the @FFFFFFFF2 stored in the first 


thirtyttwo bits of the record sioct will be woved back to the 


NEXTe-FREESRECORD fields» and the recorc will then be stored in the 
slot. If the second record stot is rot the Last in the block» 
aFFFFFFFFQ will remain in the actual tast slot and the 

NEXT»«FREESRECORD field will not te cranced. | | 


Allocation in the Direct file wilt proceed | in this manners 


-asumirg that mo DELETE operations are performed» until the disk 


area tecomes filled ard» as mentioned previously» a@FFFFFFFF9 is 
stored in the NEXT.»~FREE-SLOCK fielc. §$This value serves as an 
indicetor to the Micro MCP that the rext disk area has not yet 


been allocated by the S.MCP. When the Micro MCP encounters this 


value» it merely passes control to the SeMCP which will allocate 
the area and store its address in the disk file header and in the 


NEXTOFREE»~BLOCK field. The Micro MCP will then initiatiize the 


Block Control Information ard proceed as was described 
previcusly. | | | 


The process just described tay he irterrupted Oy the occurrence 
of a DELETE request from a user. When this occurs» the address 


ain the NEXT.FREE~RECORD slot is stcrec in the first thirty~two 


bits of the record being deleteds the Presence Bit associated 


with the deleted record is reset and the block is written to 


disk» The address of the block which contains the deleted record 
is then stored in the NEXT.~FREE~RECORD field. The next time a 
record 4s added to the file» it will consequently be stored in 
the area occupied by the record that was just deleted and_ the 


NEXT*#FREE*RECORD field will be restored to its prior vatuee This 


operation should eliminate the need to pericdicaily rewrite the 
entire file te eliminate targe numbers of empty record slots» a 
process commortiy known as “garbage coilection”. 


Shoulc more than one record in a block be deleteds the Micro MCP 
only needs to insure that the first thirty~two bits of the last 
availeble reccrd slot in that block cortains the address of the 


mext block in which a record slot is available or Q@FFFFFFFFQ if 


there is mo such next block» This is true even if alt of the 
fecords in a block are deleted. No pointers need be changed» in 
this latter case» until the next DELETE operation occurse 


Assuwing that ro rew records have beer added in the interim» the 


Micre MCP then needs only to insure that the address of the block | 


which is totaily empty is stored in the slot previously occupied 


by the deleted record. 


Allocation of space for an Index file associated with an Indexed 
Sequertial file is somewhat simpler than for a Data file» since 
record availability does not have to be maintained- Whenever a 
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record is deleted» the pointer to that record in the Index file 
is destroyed ard the table contained in the block is compacted. 
The ccunt of the actual number of entries in that blocks which is 


maintained in the Block Control Information of an Index files 1s 


decregented- No cther action is required for the Index file. 


Maintenance of the NEXT«FREEsBLOCK field of an Index file is 


exactly Like trat for the data file. This fietd wilt always 
contain the address of the next available block at the Logical 


end of the filee §The Micro MCP wilt set the field to @FFFFFFFFa 


when the next cisk area must be allocated» exactly as is done for 


the data file. 


The NEXT.FREERECORD field is used tc address a Linked tist of. 
blocks within the file that are completely empty. This can onty 
occur when all of the records that were addressed through this 


block have been deleted» a situation which should seldom occur in 
actual use. 7 


Index File lable Splitting 


The “splittine"™ of fine tables in the Index file is an operation 


that is always performed by the SeMCP.2 Any time the addition of | 
arecerd tc the file causes a need fcr a fine table to be divided 

in twop the Micro MCP passes centrolt tc the SDL portion. 
Consecuently»s the SeMCP performs most of the available space 
Maintenance for the Index files» white the Micro MCP performs the 


BTOENEY of this work for the data file. 


~The CURRENT is a structure that» for ANSI '74 COBOL» Logically 


belongs in the User Specific Inforsétion field» since there is 


onty cne CURRENT per user. There are two reasons for assoctating 


the CURRENT with the Structure Descriptor» however. Firsts» OMS 
has a CURRENT for each structure and a pointer exists in each STR 
to the appropriate CURRENT. To be compatible with OMS» each STR 
ef an Indexed Sequential file points to the CURRENT for that 
structures = A current structure nusber is maintained in the UST 
to satisfy ANSI "74 requirements. second» since the file can be 
gsharec» an operation by one user can affect the CURRENT of 
another usere To guard against this» each CURRENT is checked 
when an cperatior which can affect it is performed. To aid the 
Search of CURRENTs» they are Linked togethers the first one being 


pointed to by the STR» A POOR err, descrip syn Om the CURRENT | 
field is presented aero 2 | 
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01 CURRENT_DECLARATION> a | 
02 CURLLINK | BITC24)> 
02 CUR.JOB. INVOKES | 
«03 CUR.CUR. JOB | BITC16)> 
03 CUR-CLR-INVOKE | BITC6)>» | 
O02 CUR»STATUS BIT(Z)» % O-DEL» 1-VAL 
02 CURSFINE.TAPLE» | | 
03 CUR.AREA | BITC8)> 
03 CUR.SLOCK | BITC 16)> 
03 CUR.RECORD are BITC12)» 
02 CURSSTATISTICS» | | | 
3 CURSSTReREAD-COUNT BITC24)» 
03 CUR.STReWRITEsCOUNT BIT(Z4)> 
03 CUR.STR-REWRITE*COUNT BITC24)» 
03 CUR.STR.DELETE.COUNT BITC24)> 
03 CUR~STR«SPECIAL «COUNT B11C24)> 
O03 CUR-STReEXCEPTION.COUNT | BIT(24)> 
03 CUR-STRePHY.READ-COUNT BITCZ4)>_ 


O03 CUR.STRePHY-WRITE.COUNT BITC24)> 


The current is maintained for Indexec Sequential files which use 


either Sequential access or Dynamic accesSe When the user 1s 
accessing the file secuentialily» the current 1s maintained for 
the key of reference CUSI.CURRENT-STRUCTURE). For output filese 
the key of reference must be the oriae key = and CURRENT always 


pceints to the last entry written. For a new file» CURRENT is- 


initiatized to point to the first entry but CUR»STATUS is set to 


indicate the entry has not yet beer written. For an old file 
opened OLTPUT EXTEND» the current is initialized to the last 
entry written. The Micro MCP uses the current on output files to 


Insure that records are written tr secuencer a requirement of 


ANSI 74 COBOL. 


— Sequertial INPUT or INPUT-OUTPUT files require that the current © 
points to the last record read. On the next READ operations the 


current 1s incremented to point te the next available record. Tf. 


the. current record is deleted or the CURRENT was positioned by an 
OPEN oF START» then CUR-STATUS is set to indicate that a record 


has net yet been reade The next REAL will detiver the record and 


reset CUR-STATUS. 


Fer files in Dynamic access mode» the meaning of CURRENT is more 
complicated. The CURRENT wilt be harcled exactly as tn the case 


of Sequential INPUT or INPUT“QUTFUT. This means that some 


sequerces of operatiors may mot procuce the cesired intuitive 
result. The example betow illustrates the problem. 
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Consider the Index table at the right. | | leietiealeleateed 
What should the result of a4 READ NEXT | | | ABLE | 
bes in the fotlowing sequence of operations? ! oDOaG | 
1 GOLF { 
ae READCABLE)> ADDCBAKER)» READ AEXTs | SSS eee y 


be READCDOG)» DELETECDOG)» ANDCECHC)» READ NEXT> 
Ce READCDCE)» DELETECDOG)» ADDCCHARLIE)» READ NEXT? 


For our implementation the READ NEXT produces the following 
results: | | | 

be GOLF 

ce GOLF 


Indexed Segquertial Butte er Management 


The method of altocating buffers in prior versions of the MCP and 
in the 9.0 version for Conventionel files is known as Static 
allocaticn. This method of allocatirg buffers is simples once 
the rumber of buffers has teen choser by the usere The buffers 
are merely atlocated when the file is opened and they remain. 


assigned to the file until it is clesed. If the number of 


buffers allocated is too small» howexsers» then cperations upon the 
file say be inefficient. If the nusber of buffers allocated is 
too larger then nothing is gained ir efficercy and memory space 


as wastede 


On an Indexed Scquene ial file particularly» the number of buffers 


actually needed varies with the tyfe of operation and the state 


of the Indexed Sequential file. The optimum number of buffers is 
best chosen cynamically to avoid the disadvantages mentioned 
above. | | | 


Allocating buffers on demand and ceallocating them when the 
memory they occupy is required fcr other purposes is known as 
Dynamic allocations Dynamic allocation has always been used for 


buffers associated with a OMS data tase. It is accomplished by 
wee the MCP's memory allocation crocedure» GETSPACEs whenever 


butfer is required. Deallocaticr is accosplished by allowing 
SETSPACE. to overlay OMS buffers when necessary. Dynanic 
allocation has also been implemerted for Indexed Sequential 
files. | 


The management of buffers associated with an Indexed Sequential 


fite gresents a special protkem for the MCP» since there can he a 


variable number of them» depending upon the cperations and they 


can be different sizes» depending upon which component file is 
being accessed. To sclve the problens associated with a variable 


number of bufferss the Prioritized Memory anagoneny algorithms — 
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develcped for the 7.0 release should be used. This memory 
manager overtays buffers whenever space 1s needed and the 
priority of a buffer wakes it a candicate to te overtaid. The 


FIFCGC Memory Management algorithm car be used hut performance may 
be twpacted or a multi~orogrammine systeme 


To solve the problems associated with variable size buffers 
addressing thre same Indexed Senuentiel file» all of the buffers 
used fcr one structure are Linked tocether and pointed to by. the 
structures so that all huffers in a chain are of the same size. 


The Euffer Cescriptor is the structure used to maintain the 
puffers associated with the [Indexed Sequential file. It contains 
the recessary link fields» idertification fitelds» and state 
information. 5ince the memory manacer may cverlay the first 
buffer ain aeéechains the memory Link field» MLe-POINTER» will 
contain the structure address 30 that STReBUFFEReLIST»~POINTER may 
be updated. A programmatic descripticn of the 3uffer Yescriptor 
is presented belcw. 


01 BUFFER_ DESCRIPTOR» 
O02 BD. AREAsCISPLACEMENT> 
G3 BD.AREA BIIC8)>» 


03 BO.OFFSET RL TC16)>» 

602 BD.LUSER.COUNT | BLiTC4)>» 
02 BDeINsMEMORY 4 B311C1)> 
O02 BD. IQ-ERROR | | PITC1)>» 

—~02 ELL WRITER-~CONTROL> | | | 

(63 BD.REQUIRES.A.HRITE  BITCL)» 
03 BO.CONTROL.POINT | BITC1)>» 

O2 SO.NEXT.BUFFER.CESCRIPTOR BITC 24)>» 


O2 Ef .~PRIOGR-BUFFERSDESCRIPTOR | BITC24)3 


1/0 cescriptors are shared among alt the buffers. The BEGIN and 


ENC addresses in the descriptors may be modified when a 
descriptor is used by the Operating System. The number of 
buffers allocated depends on the number cf active structures 
associated with the Indexed Sequential file. This technique 


serves to minimize the nurber af descriptors in the disk chains 
thus reducing the amount of processirg required by GISMQ» and it 
gipimizes the memory requirements for descriptors. It does 
require an ailocation mechanism for cescriptors» in addition to 
one fer kuffers» ‘Sut this expense has heen found to be worth the 
benefits. a | | | = : 
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Concurrent Update Qeerations 


Concurrent READ operations on the same. record of an Indexed 


Sequertial file are always allowed. For the 9.0 version of the 


softwares alt loyical updzte operaticrs» WRITE and REWRITEs wilt 


be started only after all accesses to the file have been 


susperded. Ttese update operaticrs will inhibit further accesses 
to the fite until they complete. Tce usersse it will appear that 
concurrent updates to the file are aéllcwed» though this will not 


- actually ne the case 


This restriction simplifies the code necessary to insure that the 


appropriate buffers remain in memecry. Since only one update 
operation can be in process at any. given time» the update 
operation will Segin with = BD~-USER~CCUNT of zero. Orce the 


update operation uses a buffer» that tuffer's user count will be 
set to one» thus preventing the Memcry Management alcorithm from 


 overtléying it. 


Upon completion of the update operation all user counts will he 


set tc zeroe For READ operations» the user ccunt field is not 
used because each buffer need be used oanly once during the 
process of the communicate. The buffer is automatically — 


protected from being overlaid while the I/0 operation is in 


process. 


The ccdé necessary to insure the integrity of the file is also 


simplified. The Record Contention problems» the complex problems 
involving charces to the file while egrother user ts accessing it» 


are avoldede For the simole case of cne user at a time epcaynd 
the files» The simplified code provides better performance. 


Disk 140 Error Procedures 


The disk I/O error procedures in the MCP perfcrm a certain number. 
of retry operations each time a disk I/0 operation completes with 


‘the Exception Bit» Bit 1 starting from zercs set to one. 
Different procedures may he invokec» deperding upon the type of 
I/Q operation that has completed and the type of control and 
drive that enccuntered the error. MCP I/0 operations are handled 
by. a cifferent procedure which is not as extensive as the. one 


described telcwe The fotlowing description arcrlies to 1/0 errors 
on user 1/0 operations only. 


The 1/6 error procedure first checks the Memory Parity. Error bite 
Bit S in the Result Lescriotor» received from the control. Tf 


the bit is on» it performs a maximus of three retry operations» 
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logs the result and exits the procedures without investigating 


any cther bits in the result descrirtcre 


The procedure next checks the Transmission Parity Error biter S8it 
15° in the result descriptor. If tris bit is on and if the unit 
being used is not a H94B2 disk cartricge» the procedure performs 
a Maximum of three retry operations» logs the result and exits 


the procedure without checking any further. [If the unit 1s a 


BI482» no retry operations are Perr crmed for this case but and 
the irvesttaation continuese 7 


The procedure next checks the Not Reedy bit» Bit 2 in the result 
descriptor. If this bit is on» the procedure performs a maximum 


of three retry operations» logs the result and exits the 
procecure without checking any further. | 


The frocedure next checks the write Lockout bits» Bit 6 in the 


result descriptor. If this bit is or» The procedure looks at the 


1/0 descriptor itself. If the first three bits of the operation 


code are G19» 011 or i901» which woulo denote Write» Initiatize 


and fetlocater the procedure perfcrms a taximum of three retry 
cperationss blogs the result and exits the procedure without 
checking further. If the first three bits denote something other 
than the three operations Listed» Eit 6 is ignored and the. 


 anvestigation continuese. 


- The procedure next performs a Logical GR operation on: 


1. The Sector Address Error bit» Bit 10» 

20 The Seek Timeout bite Ait Tis 7 
3- CThe Adoress Parity bit» Bit 9» AND not B9482)»% and 
42 The Data Error bits Bit 3. : | 


if the result of the Logical OR operation is trues the procedure 
becomes comptex and varies with the type af disk connected. 
Before descriting the procedure fer esch tyne cf disk» some basic 


procedures sheculd be descrited. 
Ibe Gffset Procedure 


The Offset Procedure is 4a subroutire of the disk I/0 Error. 


procedure. Basically» it performs six retry operations. If any 
one cf the six effect recovery of the errors the procedure ts 
exitec immedictely reaardless of fcw many cperations have teen 


performed. The tern "offset" as used here denotes positioning 


the disk heads slightly off of the center of the cylinder | 
specified in the disk address» [In all disk pack drives which tay. 


be cernected to the BidGO system» offset may be specified in the - 
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inward (positive) or outward (negative) direction. 


The first two operations requested ty the Offset Procedure are 


| performed with the original 1/0 descriptor unmodified. The next 
two crerations are voerformed with necéetive offset and the tLast 
two ére performed with positive cffset. Tf recovery is not 


effected by any of the six» all bits which may have heen set in 
the criginat I/0 descriptor toa cause the offset operations are 
reset and the peveucure 1S exited. 


Ibe Strobe Procedure 


The term “strote™ as used here derotes beginning the actual read 
operation stictly before or after the point in the rotation of 
the cisk where it would normally begqine «© The Strobe Procedure 
calls the Offset Procedure a maximur of three times. This may 
cause a maximum of eighteen retry operations to be performed. If 
any one of the eiahteen effect recovery» the procedure is exited 
regarcless of how many operations have been performed. 


The first call on the Offset Procedure is accomplished with the 
origiral I/O descriptor in its unwodified for. This will cause 
$ix retry operations to occurs exactly as described for the 
Offset Procedure» provided recovery is not effected by any of the 
Sixe The next call is acconplishec with a bit set in the 
descriptor which wilt cause early strobe to occure  Hences 
another six retry operations may he performed» two with early 
strobe ard no offset» two with early strobe and positive cffset 
and two with early strobe and neacative offset. 


Twelve retry operatiors have been perfecrmed to this pointe If 
the error has not yet been correcteds the Offset Procedure is 
again called with bits set in the I/C descrigtor to cause late 
strobe to occure This may result in another six retry operations 
being performed» as described for the Offset Procedure» all with 

bits set in the 1/0 descriptor to cause late strobing to cccur. 


If none ot these eighteen operatiors etrect recovery» alt bits 
which may have been set in the I/0Q descriptor are reset and_ the 
procecure is exited. In the Strobe Procedure and in the Offset 
Procedure» if any retry operatior dces effect recovery» the 1/0 
descriptor resposible is entered in the Log prior to exiting the | 
Procedure. | _ | | ; 
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Ibe Etror Correction Pro cedure 


Atl varieties of disk pack that may te connected to the 581000 
system and some varieties of disk cartridge include error 
correcting capabilites in the form cf a Fire Code remainder 


stored immediately after the 144C-bit data segment._ The 
remairder is fifty "six bits in tengtrf on the 207 disk pack and 
thirty-two bits in tength on alt cthers. Te iS computed and 


stored by the disk hardware when the cata segment is written. If 
an error should occur when the data segment is read» the data as 
it shculd have been written may be reccnstructed» provided all of 
the bits in the data that are incorrect reside in the same 
“burst™ of bits and crovided the tercth of this burst does not 
exceec a specified limiting number of bits. 


The Error Ccrrecticr Procedure obtains a 29080~bit buffer from 
available memcry- If such memory is not available» the routine 
exits without attempting to correct the error. In atl cases» 
when error correction is perfornmec» cil of the segments described 
py the original descriptor are read anc corrected one sector at a 
timee For atl disk devices which stcre the 32-bit remainder but 
which dc not have the ability to ccrrect burst errors in input 
datas the procedure must operate in this manrer. Devices which 
are capable of performing error corrections such as the 207 disk 
drives are capable of doing sa on sultiple~sector read 
operations» but this feature is rot utilized by the software. 
Rather» all of the sectors are read ore sector per operation and 
the exact addresses of ail failed sectors are togqged- This 
information weuld be lost on a multigle~sector read operation. 


-€rror correction is performed oy the software for alt varieties 
of disk pack except the 207. The 207 hardware includes error 
correcting capabilities. Error correction 1s also performed by 
the software for the 89482 Disk Cartridge. The software is 
capable of correcting a six-bit error burste The 207 hardware is 
capable of correcting an eleven-bit burst. | : 


Data and Address Ercor Recovery = 215 And 225 Drives 


Two different varieties of 215 and 225 disk pack drives have been 
delivered during the Life of the 810CO hardware. These varieties _ 
are krown as Desicn Level Ore CML-1) end Desior Level Two (DL-2). 
for both varieties» the Strobe Procecure is invoked but there are 


some operational differences in the hardware itself. On Diw-i 


drives» the bits which cause plus ard @irus effset and early and 
late strobing are. ignored by the hardware» since it does not 
include these capabilities. © Consecuertly» on Dint drives» a 
total of up te eighteen retry operations will be ner or wed by the 
strobe Procedures but they ot sc REat ty, be nothing more than > 
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eighteen repetitions of the original I/O descriptor. ODL-2 drives 
include a full complement of offset znd strobe capabilities. The 
software cannot distinguish between the two types of drive. 


if nene of the etghteen retry operations caused by the Strobe 
Procedure effect recovery» the [/0 cescriptor is restored tc its 
origiral state» and the Error Correction Procedure is invoked. 
Each segment described by the [/0 descriptor is read individuatly 
and error correction is performed» if possible» by the software. 
In all cases» the results cf the reccvery attempt are entered in 
the Engineering Loge 7 


Data ang Addcess Error Recovery = 205 And 206 Drives’ 


For 205 and 295 disk drives» the Strobe Procedure is performed 


exactly as it is described. Eighteen retry operations are 
performed» two operations with eack possible combination of the 
strobe and offset variants. If any cf these operations effect 
recovery» the /0 descriptor is restored to its original 
condition and the precedure is exitede If not» the Error 
Correction Procedure is tnvoked with the I/0 descriptor in its 
original condition» Error correction is rertformed by the 


‘software for 205 and 2C6 drives. 


In any case» the results of the reccvery attemot will be entered 
in the Engineering Log prior to exitirg the procedure. The I/70 
descriptor is always restored to (its original condition prior to 
exitirg the procedure. | 


Data end Address Error Recovery = 207 Drives 


207 disk drives include neither offset capabilities nor strobe 
capabilities. The hardwere does include a capabtlty tc vary the 
threshold of a read operation but its use is rot recommended for. 


recovery purposes by the manufacturing plant. Consequentl y» the 


Strobe Procedure is net invoked fer 207 drives. Two retry 
operations only are performed» both using the original version o 
the I/0 descriptor» If either operztion effects recovery» the 


fesults are tlogged and the precedure is exited- If not» the 


Error Correction Procedure is invokece 


207 drives include error correcting. capabilities in voe hardware. 
Additionally» the hardware is capatle of correcting all errors 


that ere correctabie in alt sectors cescribed tin one multiple 
sector operation.  $This multiple sector capability is not 


utilized by the software» however» end each sector is read and 


corrected incividuallye | This is ¢cne_ for ean ere, purposes — 
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onty» to isolate the address of the failed sector(s) and insure 
their entry in the Encineering Log. The results of the recovery 
-attemcet will te logged and the procectre will be exited with the 
i/0 descriptor restored to its origirat condition. 


‘Data and Address Ecror Recovery = Disk Cartridces 


For att versions of disk cartridge except the B94B2»5 the 4400 
BPI» 203 or 406 track» 64 sector per track variety of cartridge» 
the error recovery procedures are very siaple. The procedure 
merely repeats the original operatior a maximum of three times. 
The results of this attempt are logged and the procedure is’ 
exited with no further checkinge There are fro other options 
available in the hardware which fight hetp in the recovery 
attempt. _ : 


For the 89482 cartridge» the reccvery attempt is slightly more 
extensive. This drive has error correcting capabilities similar 
to these of the 206 drive. Error ccrrection or a Read operation 
is performed by the software in the Error Correction Procedure 
exactly as it is described. On 4a hrite operstion» the recovery 
attemept is actually mcre complex thar for a disk pack. oe 


when a Write error occurs on the 89482 cartridges the I/0 Error 


procedure will attempt to cerrect the errors if the three retry _ 


operations mentioned above fail» by writing the data one sector 

per operation. In the case of an Address Parity errors the 

procedure will also attempt tc srite that sector plus the 

preceeding sector in an effort to ccrrect the address parity. 
The results cf the attempt will te tagged and the procedure will 
be exited wher recovery is effected cr when ali retry attempts 
have been completed. | ‘. | 


This concludes the discussion of Data and Address Error Recovery 
for the various drives thet may be cecnnect. The remainder of 
this section describes the remairing tests in the I/0 Error 
procedure. | a : | | 


Remairder of the Disk 140 Error Procedure 


Jf the results of the Logical OR operation mentioned previousty 
were false» the I/C Error procedure examines Bits 22 and 23 of 
the result descriptcr. Tf both bits are set to ones they 
indicate that an Extenced Result Descriptor wes returned with the 
operations though the ERE! may not be stored in MEmMOorye — The 
procecure stcres the Extended Result Descriptor» if it is 
. available» in the Engineering Log anc. perforas a Maximum of three 


37-85 


BURROUGHS CORPORATION | | COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP . _ 3 81000 MCP II 
SANTA BARBARA PLANT 7 Pa Se 2212 5462 Cf) 
retry operations using the original 1/0 descriptor. The results 


of the attempt are togged and the precedure 4s exited with no 


- further checking. 


pana live if all of the tests mentioned to. this point were false» 
the procedure performs a maximum cf three retry operations and 
logs the results. ‘Since an exceptior did occur» indicated by the 
setting of Bit 1» the data is assused to te corrupt and an 


attempt is wot to correct it. 


Tape 1/0 Error Procedures 


There is one I/0 Error procedure that is invoked for alt tape I/0 
operations that complete with the Exception tit in the result 


descriptor sate The procedure is irveked regardless of whether 
the cperation was a user I/Q or an MCP I/O. It is also invoked 
on tte coepteticn cf Test operatiors» where the setting of the 
Excepton bit is a normal occurrence. It is atso invoked for 
Emulator Tape operations» though in this case» it may do nothing 
more than pass the result descriptor on to the user for 


resolutions 


Peseniiatiye the procedure will retry the operation a fixed 
number of times and return control tc the procedure which calted 
Tte If recovery was effected» this will be so indicated tn the 
previcusly failed result descriptcr upon return. If the 
procecure was not able to effect reccverys» the result descriptor 
will contain an indication of the failure upon returne In most 


Gnstarces» the procedure will retry the operation ten timessr but 


this rumbter will vary with the tyre cf failure and the operation 


atteapted- 


‘The Gane T/C Error orocedures will be described fully tn a 


_ subsecuent version of this specificaticne 
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This section of the specification has two principle - parts. 
S™meacry management is described at the functional tevel. 
. S*mercry requirements for a given system configuration are then 


presertede Using the second part ef this section» it should be 


possitle to estimate the amount of S-memory that will be required 


on a system to support a given program. 


Stmencry management. techniques were changed drastically in the 


7-0 version of the software and were changed again in the 9.1 


versicre Tre discussior contzined in the first part of this 
—  secticn may not be applicable» in alt cases» to versions of the 
jena s ee wee 2 to the 9.1 version. 


GENERAL nEmoRy manacceser CONCEPTS 


- The: atoce seftware utilizes a. “segmentation” form of memory 
. Management.» In such a system» memory is requested and allocated 
only when it is required and only ir the amourt that will exactly 
satisfy the reaueste In other words» memory is divided into a 


variable number of segments» each of which is of any sizes with 


some chvious restrictions. A basic element in this form of 
memory management is the “memory Link”. : 


The forwat of the memory Link was fresented in a prior section. 


Basically» it contains a size field which may contain any value 
from zero to 169777215 bitse It ccentains the addresses of the 
memory Links that precede and succeec it and the address of an 


associated secoqment dictionary entrye “It contains a nuaber of 


other fields» which will be discussec in turn. It is created and. 
maintained by the “MCP and the executing interpreters store 
selected information in. ite In atl cases» it tmmedtately 
precedes the segment of memory ehet it describes. _ ‘fa ee 


| tau sau ae 


Sinkiaanus blocks of. memory are reserved for system use at the 
extrene ends cf the memory on any SyStemMe. This is described th 


more cetail in the second part of this section. Between the two |. 
| contiguous blocks Lies the area knowr as "Linked memory” At the | 
end cf the reserved area at the lcw end of memory» | there is a 
dummy memory Link known as the Lower Termirating Memory Link 
C(LIML). At the beginning of the reserved area at the upper end 
Of Mewory is ane nen, eee Beeery Link CUTML). 


2 a gies tat etched i ia wor thi 7 Aly 2 de tseyerert ta ain! ih atta he he sine eraanes att eek 
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The terminating memory links are created durirg the Clear/Start 
procedureée Each has a size field cf zero» a tyne field which | 
specifies the grea as TERMINATING.LIAK» but the “save*™ bit wit! 


be set to one in both links. This atlows the memory management 


proceacqures to recognize the termireting memcry Linkse © The 
backwerd pointer in the CTML wittl contain aFFFFFEF a> but the 
forward pointer will contain the address of the next memory Links. 
in address order. Simitarty» the backward painter in the UTML 
witl contain the address of the previous memory Link in address. 
orders the forward painter’ will contain @FFFFFFe. 


Hencee atl memory links form a chair in memory. The memory Link 


which immediztely precedes each ellocated memory area will 


contain the address of the Succeeding and preceding memory Links 
an the forward and backward pointer field respectively. The 


chain with ke terminated ir the fcrward direction by the upper 
ter@irating memory tink and in the backward direction by the 


dower terminating memory tink. 


The area known as Linked memory is an example of a "memory 


subspace"» as this term is used herein. There may be = other 
memory subspaces within tlinked teftory. The Run Structure 
CBase/Limit area) of certain programs may also be divided and 
allecated upcr request by the softweree The same procedures in 


the scftware are used to manage these smailer memory subspaces as 


are used to manage linked memory. 


IYPES CE MEMORY REQUESIS 


Memory requests may originate ir a number cf diverse manners. 
This ts evidenced by the large number of different vatues' the 


type field cf a memory link may contain. The most common 


occurrence cf 4a memcry request is fcr a ccde segment to he 


brought into memory. Other requests originate when a file is 
opened» when the MCP needs additionel temporary storage for the 
performance af one of its tasks» when additional space is 


required to hold a queue messagee arc so forth. 


There is probably no need to discuss each different type of. 


memory requeste Mary of the numbers assigned to each dif ferent 
type cf memory request are for the bterefit of the Dump/Anatlyzer 
program anly and have onty pathological use- The different types 
of recuests have2 common characteristics and may hence be grouped 


into "classes". The common characteristics will be described and 
explained. | | oie of | | | 
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Parameters that are gassed with a mencry request are the size of 


‘the required memory area in bits» the address of the dictionary 


entry which will be associated with the memory areae if anys the 
address of tre Run Structure Nucleus of the crogram which caused 
the request» if any» the type fielc to be stored in the memory 
Link» the priority of the recuest» a beclean variable which 


specifies that the memory should be aktlocated at the highest 


possible physical address and a boolean which specifies that the 
memory must be allocated above the “ferce™. 


TEE FENCE 


The wcP has one set cf stacks» only» to store the variables that 


tt must manipulate ir the performance cf any functions This set 
of stacks cannot ce stored anywhere elser they must be 
maintained in memory until the function has been performed. 
Consecuently» cnce the MCP begins perfcrming any functions it can 
perform no other function until the criginal task is complete. 


Almost all MCP furctions require scre than one MCP code segment 


to cogplete. A file Open may require more than thirty code 


segmerts to be brought tnto memory. The numter of code segments 


required could obviously be reduced Ly making each code segment 


larger but this would atso reduce the possibility of finding 


sufficient memcry on small systems. It would also possibly cause 


more user coce segments to be reacved fron memory to make room 


tor the targer MCP segment. 


Should the MCP begin performing a certain request and not be able 


to find sufficient memory to contain a necessary code seqmentes 


the system would have to halt. A Clear/Start would then he 
requireds with its resulting loss of atl frograms that were 
running at the time. In order to insure that there will always 


be sufficient memory to bring in the Largest VCP code segment» a 
fence is established in memory» belcw which only code segments 


are gllowed to residee The tecation of the fence may he 


calculated by adding the size of the largest MCP code segment and 
ats associated segment dictionary to the address of the lower 
termirating mesory link. | 


Certain exceptions to the statemerts in the paragraph above 


QkIGt.. Code segments may not be cverlayable at all times. To 
pring a code segment into memorys tre memory area 1s allocated — 
and an 1/0 operation tinitiated. The mercry area may not he 


deatlccated urtil the I/0 operation is complete. Shoutd the MCP. 
encourter such a situation and not be able to find a required 


memory area arywhere else in memcrys it with wait for the 


4 SOMD ESET aN of the operation. 
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Certain code segments associated with MICR applications programs 
are also not overtayable. This is also true of segments of the 
interpreter used ty such programs. Corsequently» the fact that a 
memory request is for a code segwert is not sufficient to 
determine whether the memory should te allocated below the fence 


and tre bootean variable is requirede 


com anne ae ae! aay em ome eee om: 


Checkerboardings alse known as Exterral Fragmentation» is the 


condition which exists when memcry contairs a large number of 


permarently-allocated areas» or “save" areas»e most of which are 
separated by small overtayable areas. In such a situation» the 
tcetal memory available may well be tzerge enough to satisfy a 
given request but no single cortiguous overtayable area is 
sufficiently large. This situatior can have a serious imcact 


upon performance. 


To minimize the possibility of the cccurrence of checkerboardings 


the CP attempts to allocate alt memory denoted as 
nonsoverlayable or “save” at the highest possible physical 
addressee Examples of items which are se allccated are program 


run structures» files and I[/0 buffer ezreas. 


MICTIN SELECTION 


When € request for memory allocatior is recetved» the management 
algorithm gust select a “victim™» @ pertion of memory which 1s 


alreacy allocated which may be ceattocated and assigned to 


Satisfy the nen request. The area to be allccated may also be 
marked Availabie> of courses thcugh this is seldom the casee 


"Victim Selection™ is the process of determining which allocated 
memory segment or segments will be deallocated. This 1s the most 


intricate task of the management algorithms the task which 
requires the most attention te strategy ard the task which 1s 
most influential! upon the performance cf the systems Two victis 
selection alcorithms are provided in the softwares Users may 
chocse either the priority Victim Selector or the Second Chance 
Victiag Selector via a system opticn. The change is only 
effeccted during 3 Clear/Strat operatione. 
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RCELNO“ROBIN VICTIM SELECTION 


an eb ae ane ae wan em ome SO Cn eh ah <a coe me ante wah am en 


Prior to the 7.0 releaser victim selection was essentiatly a 
round"robin among reauestse The MCF kept a pointer which served 
as the starting point of each search ard was updated after each 
allocation to point to the end of the rewly allocated area. This 


pointer is tycrically referred to 4s the "*leftcoff pointer” The 
round-robin algorithm had the advantages of being computationally 
simple and it served to minimize external fragmentation» but 


there are some serious disadvantages associated with this victim 
selection algorithm. Specificatly» . 


1. It has no knowledge of which seguerts. are actuaily in usep 
 elemerts cf the “working set"™» and | So , 


2. The memory. rescurces of each job have equal importance. 
| unlike pracessor scheduling» the memory is not attocated on a 
pricrity. besise _ 


These flaws Lead to sone bad performance degradations in certain 
situations. Cre such problem is the “cascadirg” phenomenon. 


edhe Denning'"s detindevans aprogréea#'s working set WCT>» t) is 
the set of ali segments accessed by the procram in the interval — 
CT-t» TT]. Denote the size of this set Cin MCPII contexts size is 
tn bits)» és WCTs t). This definition affords us useful 
information with which to manage reai store whenever the change 
C"drift") from the set WOCTO» t) to the set WiCTi-» td is small 
for the interval ([TG» Ti]. The assu@pticn tehind working set 
management is that for many prografs» the drift is indeed small 
during most of their execution lifetimese : 


Postulate a situation where the code and dictionary segments of a 
single job completely fill overtayable memory. The round-robin 
algorithms having no information concerning WCT» t) made a choice 
of victims among the resident segments which was essentially 
random with respect to this infcr@atione Cail the . ratio 
WCTe t3/Csize of avertayable memory) the saturation ratio Se 
Then the probability is approximately § that the incoming segment 
will overlay one or more elements cf WCTs td). The overlayed 
segments» of courses will immediately be needed again and has a. 
probability cf about S of overlaying another element of WCTs t). 

This sets up an undesirable oscillaticn which should eventually 
damp back to stability» assusing no further external 
perturbances». The probable number cf extra cvertays required to 
reach stability increases with Ss» ard hecomes quite targe when § 
exceecdSs sayr Q.92 We call this cscillation “cascading” of. 
cverlzyse For Large values of S$» almwcst alt time is consumed in 
waiting for Ise on the backing stores so very Little work gets. 
donee This is the situation commonly known as "thrashing". 
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Nowe suppose the memory. manager has some knowledge of the. 


elements of WCT> t). If the saturation ratio is not too close to 
ores it will usually te possible to select a window containing no 
elemert of WCT» t). The chance cf cascading segments is thereby 
decreased in configurations running with S in the range of 0.25 to 
0e/5-6 The difficulty ts that elemerts of WCT>s t) now clutter 
memory and increase external fragmentation. As 5% approaches Cor 
exceeds) ones», this becomes an importart loss and makes selection 
difficult for the memory manager. At this pcints the advantages 
of the round~robin strateay begin to cutee eo the advantages of 
utilizing working set information. | | 


WORKING SEI DETERMINATION 


In order to determine whether or not a code segment in memory is 
currertly being used» usage bits were added tc the memory link in 
the Z.9 version of the software. These anpear in the 
programmatic description. of the | memory Link as 
MLePREVIQUS.~SCAN.TOUCH and ML.~.CURRENT.SCAN.}jTOUCH. Whenever an 
interpreter accesses a code segment cictionary entry and finds 
the associated code seqment presert in s#emory» it sets the 
currert scan touch bit to a value cf ones Interpreters make such 
an access whenever they are reinstated and whenever a code 
segmert transition cccurse It is ret necessary for interpreters 
to set the Lit in wemory Links which are asscciated with segment 
dicticnaries. These are usually marked as save space if any of 
their code segments are present in memory. Also» data segments 
are always overlaid in a round-robin fashions regardtess of the 
wvictia selectcr that is currently beirg used on a system. 


SECOND fu ANCE VICTIM SELECTION 


The Second Chance victim selection algertihw, first introduced in 
the 9.1 version of the MCPs addresses the first failing of the 
-round*robin algorithms the tack of knowledge of the working set 


of the code being usede | Also»e tke Second Chance algoritha 
completely supplants the old round~rchin strategy- The latter is 
no lenger available for usee- The change is completely 


transparent to users and the onty ncticeable effect should be an 
improve@ent in performance in installations where the round~robin 
algoriths was used prior to release cf the 9.1 software. 


The Second Chance algorithm utilizes the left~off pointer 


described for the round-robin algoritha. It kegins searching for 


a memory space targe enough to satisfy the request at the 


heftcoff pointer but it witl not select any space whose’ touch 


bite» ML.CURRENT.SCAN.TOUCH» is sets. Upon ercountering a memory 
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segmert whose touch bit is set» it resets the bit and continues 
to the next mewory tLinke It will allocate the first segment it 

encounters thzt ts sufficiently laroce and whose touch bit is 


reset. 


This algoritha thus has the major advantage of the roundwrobin 


algorithms it is computationally simple and the. frocesing 


required is minimized. Untike the Prioritized victim selection 
algoritha described telows it requires no knowledge or action on 
the part of the user. | 7 oo 


PRIORIJIY VICTIM SELECTION 


The second failing in the round=-reotin strategy is its inability 
to insure rapid turnaround to jobs which are designated as_ high 


priority. In MCPII» prior to the 7.C release» only the processor 


was allocated on the basis of pricrity. A high priority 


application was conterding for the menory resource on exactly the 


same footing as a low priority “*backcround™ jcbh. This ted to 
severe performance degradation for users which required many 
overtlayatle memory resources but . frequently relinquished 
processor control to make operzetirg system requestse- In 


particular» datacomm anplications rurning in multiple job shops 
were suffering badly- Background jobs tended to usurp critical 
resources forcing the datacomm application te loose control still 
more frequently» allowing backgrcurd -jobs to runs grab more 
memory resources» and so forthe | | 


The Prioritized memory management alcorithms first introduced in 


the 7.20 version of the MCP» addresses both of these problems. 


The priority victim selector makes its choices on the basis of a 


priority field in each memory link. This field is maintained hy 
runtisve use of working set informatior. The priority field will. 
be maintained at its original value as Long as the code segment 
is not used. This field is known as the Residence Priority fietd 


and is shown on the programmatic memory link description as 
MLeRESIDENCE PRIORITY. | | 


- Associated with each program running on the system is a Memory 
Priority field. The memory priority value determines the ability 


of the program's code segments to overlay the code segments of 
other programs running on the syste@. Memory Priority is stored 


in each memory tink associated with each of the program's code 


segmerts. It is shown programmaticelly as ML~INCOMING.PRIORITY. 


Memory priority is atso stored iritiaity in the Residence | 
Priority field. Whenever a request for a new code segment to be 
brought into memory is received» tte memory priority of the 


associated program is coapared to the residence priority of every 


memory Link currently presert in the system memorys The current 
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implerent ation of the victin calacccr always chooses a victim 
having the lowest. residance. Sa ate a 


An exception must be made for MCP coce segmentse As presented in 


a prior paragraph» the MCP cannot be denied a requested code 
overlay without halting the system. Consequently» MCP code 
segmerts have an imperative inccming priority» hut their 


residence priority value will decay at a rate equal to or greater 
than the programs. running on the systefRe 


At a user~specifiec interval» a rcutine in GISMO known as the 

sweeper is executed. This routine moves the setting of the 

currert touch bit to the previous touch bite destroying the prior 

setting of the previous bit and settirg the value of the current 

touch bit to zerce This routine is ciscardable and is eliminated 
by the initializer if the system is running with the Second 
Chance victim selector. | 3 


The cefault time period between executions of the sweeper is 890 


milliseconds. Users may vary this tiwe period via a keyboard 
instruction within certain rangese ‘Since the sweeper routine may 
be executed between any two S~cperations» all code in the 


software. which Ranipulates memory Links must always insure that 
the chain formed by the address pointer fields is intact. 


ebor the sweeper has moved the currert touch bit to the previous 


_ touch bite it then examines the previcus touch bit. If the vatue 


is zeros it increments the current decay interval fields 
MLeCUFRENToDKwINT> by the value of the sweep interval. If the 
value of the current decay interval is equal to or greater than 
the specified decay inteval»  ML.CK~INTERVAL» the residence 
priority field is decremented. a | = 


The default value of the specified decay interval is zero. Users 
May specify different decay irterval values via a keyboard 
instruction. _ Users may also specify. that certain code segments 
within a program are important ard that their residence priority 
should not decay until the specified decay interval has elapsed. 
This is accomplished via a suppliec normal-state program which 
anipulates ccde files resident on diske The residence priority 
Of ccde segments which are not warked as important will decay. 
after the default decay interval» zerc seccrds» has elapsed. 
NOtices however» that this cannot Cccur for at least one sweep 
interval. | 


When executine with the aevoraiey victia Selector: the MCP Beate 


maintains a Left~off pointer. When the system is thrashing» when. 


the residence priority fields cf atl memory Links have equal. 


esusuemmasis CEIECIIUN DE MEMORY IbRASHING 
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values» the victim selected will certinue te. be the next “memory 


area telow the left-off pointer. 


Bo 


_ One ct the serious problems confrontirg Vieeoal. storage systems 


1s memory thrashing. Qn the 81CCC Syste@s» memory thrashing 
occurs when the working set of procecures for a program or set of 
progréms will rot fit withir the portion of main memory available 


for overtzys. When this state cccurs» the system's performance 
oDegins to decrade. The amount caf degradation depends on the 
overlay space available, the size ana rumber of segments 


competing for memory» and the eae of segment transitions. 


As the amourt of main memory is reduced for a constant 
progrémning task» the amount cf degradation due to memory 
Overlays norwally appears very gGraecual at first. — As the 


availéble memory js furtner reduced» a point will be reached 
Where the degradation due to overlays increases rapidly.» This is 
the pcint where the main working set cf procedures no Longer fit 
1n #&in memory and are competing for space. This point. 1S 
defined as the thrashing point and is shown mn Figure 4ela 
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As seen in Figure 4.1> execution of the procramming task with. 
Less memory than indicated by the thrashing point yields 
inefficiert execution times ir reaior A. So 7 : 


Beginring with the 7.C version of the softwares the MCP includes 

a prcgrammatic facility for detectirg a thrashing condition in 
the syste. The facility ts inctudec in GIS¥0 as a discardable 
segmert» it 315 retained or discarded during the Clear/Start 
operatior baseco upon tke setting of é€ system cptione It may be 
used with either victim setection alccrithme It must be used if 
the priority victim selection algorithm is usede’ | 


The facility ts actuated by a clock saintained in the software. 
It utilizes a count of the number of overlay cperations performed 
by the softwares. The count is alse maintained in the softwarer 
of course. The sweeper routine discussed previously is actuated 
by the same clock that actuates the thrashirg detection routine. 


At a user-selected interval» the thrashing detector compares the 
rumber of overlays which occurrec durirg the interval to a 
user-specified target number cf cverlays. If the overlay target 
is exceeded» the thrashing detector suspends temporarily the 
execution of the sweeper routine and tegirs a ccunt of the number 
of iccnsecutive intervals during which the number of overlays 
exceeds the target number. The eltcwable number of intervals 
during which thrashirg»s as defined ty the user» is detected is 
three. . ee | 7 


If the thrashing condition persists fer three intervals» the 
software infcrms the operator via a SPO messages The message 
will te repeated at N-SFCOND intervals until the conditior abates 
or until the cperator requests» via another SPO message» that it 
not oe displayed continually.» The software also disabtes the 


schedule wher thrashing is detectec so that no new jobs are 


initiated. The schedule will be autcmatically enabled again when 
a preoocram currently being executed terminates. | 


MEMORY INITIALIZATION 


Memory is initially atlocateag by the software during the 
Clesr/Start operation. This sirgle cperaticr is composed of 
several components. For discussion purposes» it may be thought 
of as two sepgrate operationse The first of the two is the 
execution of a stard=atone routire» . commponty known as the 
Initiélizer and stored in the disk directory as SYSTEM/INIT. The 
initializer is ckrought into memory by the Clear/Start code 


contzined on the cassette. The seconc operation is the execution 


of some code in the MCPe contained in Page Zero» Segment One of © 


Wadd 
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the MCP*s code file. 


At the completion of the inicializers memory will be formatted as 
Shown in Figure 4.2. Permanently allccated areas will be tocated 
at each end of memory. Linked wemcry will consist of four links 
only. The processor is then Passed tc the MCP? 5 code segment for 
completion of the Clear/Start operatiore Upcn completion of the 
MCP ccde» Linked memory will te forwetted as shcwn in Figure 4.3. 
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MAXIMUM ADDRESS 


GLSMO DATA SPACE 
[See Se" 43 te Sse ee eee eae = SS] 
! ENTER eee { 
a aa a a a al | 
," See Note 2 / 
/ / 
je Sere Sesser SSS esse = SSeS ees = i 
! Bispaiee TRACE SPACE ! 
Se ae a me vane em ae ene ee ieee i 
| GISMN COCE { 
{Se cSe <= SSS ee SSS SS SS Se =< =f 
1 MICRO MCP. DATA SPACE. I 
(S23 S$ 5 Sees SS 5 See ere Se See a i 
1 MCP RUN STRUCTURE NUCLEUS : 
coer > Pn me ce ew nw we ee ee me enn nnn] | . 
i 4 | 1UTML!I See Note 1 
! (ss = | SOL INTERPRETER {pare | 
{ 1 ML 4 : | 
i [SSS sSSS> = = see SSeS = (Se eae Seas | 
4 
Linked / | . _ .* & 
Memory i aa | | | | J 
i (=== { 
i i ML 4 1 
f a a aca ac aa a | 
1 1 | MCP SEGMENT Op» 1 1 
i [Ase serena 4 | | 
i i tTML - wt ol 1 
i--ss= Pi Re ae eH Se ses ese Seas ohme aie Seea= 
i MCP SEGMENT C»Q ] 
jr mn a a me = an a ee ee ee | ee! ee a ee | 1] 
t CHIP ERROR TAELE j 
aaa eh ce lc i 
: COLD/START VARIABLES 4 
(SSsSssSSe=>-oSee= === Sees es =: | 
1 Pe Lene Oren DICTICNARY ee 2 
porte ee ww ema wee wee enw ame aewnae { 
i MCP SEGMENT 8 PAGE [ICTIONARY | 
[SSeS eees SS sos SS SSS etateal | 
1 MCP STACKS | 


ADDRESS ZERC 


Ficure 4e2 Memory Format After Initialization 
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Figure 422 Notes 


1. “LTML” and “LIML™  #‘are a@creryms for upper and lower 
terminating memory tinks. These two links have a size fietd 
cf zero anda type field which denotes 32 terminating memory 
Link. The upper Link has a tecrwerc pointer of @FFFFFFIs the 
Lower Link has a kackward pointer of aFFFFFFa@. The Links are 
used to mark the boundaries of tlirked memory for the memory 
allocation routines. Metory ailecated by these routines wilt 
always tie hetweer. these two lirks. . 


¢- It is possible» during the initiatization Frocedures» for the. 
operator to specify a:maximnum S-memory gadress that is less 
than the actual waximum address cf. merory on the system. 
when this is done» ~ a proportionate amount of memory is 
reserved at the Location showr. This menory is» in effect» 
deleted from the system. Mencry may also be deleted via 
certain keyboard Instructions avéittable ta the operator. In 
the tlatter case» the deleted wemory may Lie at almost any 
acdress in the system. 


ala 
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, | > $b UTML J 
{=-51 ~ SDL Pe eneien, [sees== 1 
PML tt a 1 
psn aeess Sena nesta ee ea Ss en acres ==] 
! PORT/CHANNEL TABLES 1 
P=~"-1 SPQ VAR®TABLES AND SUFFER ft 
| | of 
[Sossse sss e= Sees <s Sea eos ses ess | 
TOAT» TAPE PAUSE AND ~~ J. 
Im---f TAPE LOCK DESCRIPTORS 
1 ML | -. +." i 
[Sasecs< Se oe nie eas a Sess eeeS === i 
| ADDITIONAL FORTI/CHANNEL 1 
prcas | TABLE fd 
i wt | i 
[See sel ssSSs2 Sheers Sees == Soe ss i 
| QUEUE DISK TEMPLATE i 
bee re i 
i ML t | i 
[Sirs see nSses aes s= am eine cn aloe I 
i MICRA NCP SEGMENT. i 
pas==| DICTICNARY | i 
1 oML I a a ' 
Paaeses 2SsSeses [asses == 2<--— << { 
i SDL INTERPRETER SEGMENT { 
passe [- DICTICNARY | 
Domt t | : I 
 eteiettetertetetetetetatetetetates oe eee ee eenn-- I 
ERD AREA i 
(=== 
4a ML OI | 
. er eree= See SSS Seco = 2 Sana mee 1 
4d | | i 
ae aoe see Note 1 / 
/ | f 
| | . « Ws od 
“PENCE LOCATION: ): (2) S08 SS oe 1S) ee ee ee 
| | ia ' = 
[2seee= i 
[ LIML | | of 


Figure 4.3 Linked Memory. Format After Clear/Start 
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Figure 423 Notes 


1. Though nothing is shown as presert in figure 4.3 between the 
SCL Interpreter Segment Dictionary and the Lower Terminating 
Memory Lirks this area will typiceily be filled with MCP code 

“segments at the coapletion of the Clear/Start operation. 


2- The purpose of the fence showr in figure 423 was discussed 


previously. The tocation of the fence is retained in the MCP. 
stacks. It is not necessary to reserve any BORE: at all at 
the fence location. | 7 | 


MEMORY RECUIREMENTS 


The memory that will be required to execute a given program or 

set cf programs is composed of four componerts.e There are the 
static requirements of the operating system» the dynamic 
requirements of the operating systems» the static requirements of 


the program ard the dynamic requiremerts of the program. 


Static requirements are composed of the data spaces necessary to 


operate the system and the program. Cnce the static requirements 
are established» they typically de nct chance. for exagsples once 


a program has all of its files opens the mencry reouired for the 
File Information 8tocks and the buffers remair fixed until the 
files are closed. In the case of the MCP» once the system is 
Clear/Started» the static pocarenerts remair fixed until the 
Systew is Clear/Started again. oe | | | 


Dynasic requirements are exclusively code segments. Assuming 


that a@ working set of the code segments of a program is 


established» the dynamic requirements for that program will then 


be the total amount of memory that is required to contain the 
code Sennett that are a part of the working set. The operating 
system's workirg set depends» of ccurse»s upen the communicate 
operators that are issued by the procram in its own working sete 


OPERAVING SYSIEM STATIC REQUIREMENIS 


Those items shown in figures 4.2 and 43 comprise the static 


mgmery requirements of the operating system. Each item will now 


be discussed and a means of deter#ining the amount of memory 
required by the item will te presented. | = The numerical values 


preserted herein apply to the 920 version of the MCP onty. 


MCP 
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MCP Stacks | 


The stacks used by the MCP will always reside at location 


zero in S-memory. For each released version of the MCP» the 
stacks will be of a fixed size» regardtess of the machine 
configuration. The stacks require roughly 346416 hits = or 
4302 bytes. | 7 | | 


nage Dictionary and Segment Zero Dictionary 


These tue ttems may. never te icone and are maintained in 
memory im@ediately above the WMCP stackse They will also be 
of a fixed size for each released version of the MCP. ~~ The 
10.0 version of the MCP code is divided into thirty-four 
segment pages and Page Zero contains thirteen segment Se Each 


entry consists of a system descricftors which requires 80 bits 


or 10 bytes. For the 10.C version of the MCP» this item 


requires 3760 bits or 470 bytes cf memory » 


Interpreter Dictionary 


An Interpreter Dictionary entry requires 224 bits or 28 
bytese The number of interpreters that may be used on a 
system at any given timer and hence the number of entries 


attowed ir the Interpreter Dicticnarys tay be specified by 


the user to be any value between 2? and 31. If the user does 
net specify this number» the Coltd/Start routine wiltl set this | 
value to sixe The memory recuired for the Interpreter 
Dictionary aay be ecalculated by multiplying the number of 


JOCERDRe Tens allowed by ‘the size cf one ertrye 


Cold/Start Variables 


The variables contained in this area are criginally set by 
the Cotd/Start routine. Many cf them may de changed by the 
operator. The memory allocated for their storage may not be 
changed- | -It wilt atso be a corstant value for each version 


af the operating systea. For the 10.0 versions the memory — 


peaueres 1s 2256 (bits or 282 hy tes 


Chip Error Table 


This area is allocated on 818CO and 81900 series machines 
orly- Qn att other machines» nc memory is required for this 


item. On the 81800 end B190Cs the area is used to store the 


addresses of memory locations which are exoeriencing 


correctable memory parity errors. The size of the area in 


bits may be calculated by 40 plus (32 tises the number of 


 ertries allowed in the table). The operator may specify the 
number of entries the tabte Shoulc contain. The default 


MCP 
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vatue for the number of entries weet be. one entry per 16K 


cytes of omenery on ene SYSTERs 


Code in Page Zero» Seqment Zero 


This code segment is normally referred to as "Segment Zero” 
ard the size of the segment is a constart for each released 


version of the MCP. This is the cnly MCP code segmert which 
dces not require a memory Link» sirce it is outside of linked 


memorye $ The code seqment requires rae A 930490 bits or 


€€86 bytes of memory. 


Upper and Lower Terminating Memory Links 


SDL 


MCP 


Ir the 10.0 verson of the softwares. a memory link requires. 
1€7 bits of memory. These two then require 374 hits or 47 
Cytese | | oe | 


Interpreter 


The sizes of tte SCL Intercreters presented here are for 


reference only. Accurate size figures arc figures for the 
verious segments of the irterpreters are provided in the 
appropriate product specificaticn. Segment dero of the 


S-Processcr version of the SEL Interpreter requires 8166 


byteSe The same segmert of the Mo Processor version reauires 
8C24 oes 
Run Structure Nucleus 


The MCP requires a Run Structure Nucleus field as does every 
Other program which executes on the “system. For the 9.9 


yersion of the softwares» 2386 bits or 298 bytes are allocated 


for this field. 


Micrce MCP Data Space 


Currently» 1249 hits or 156 bytes are allocated. en this 
Spacee This reauirement is a cerstant and is not dependent 


upon machine configuration nor system options selecteds but a. 


Guat EEC SeS Sr coming aye ae cee: two such ‘Spaces. | 


~GISME Code — 


GISMO is net sCanented: . Selected portions of the GISMO code 
are "discarded”™ by the Initiatizetion routine if they are not. 


required on a given systen configuration with a given set. - 


. Systea Spr rons: selected. The agaount a memory that hs 
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required to . § contain GISMO must therefore atways be 
calculated. | _ | a _ 
The Main Block of GISMO requires 5500 bytes of memory. No 
memory link is required. The amcunts of memory shown in the 
fcllowing table should be added if the corcition specified is 
true. | | _ | 
System equipped with Memory Base 5 é a 104 bytes 
Processor is 2a 81830 Oo 436 bytes 
Processor is 81720 series | 940 bytes 
Processor is 81860 series a 642 bytes 
Processor is Duat B18XxX | oe. ¢ 1070 bytes 
Reference address check option set 7 | ‘138 Gytes 
 Thrashing detection option set ; : 142 bytes 
Prioritized memory PaaS option set | 364 bytes 
rCUT cpticn set | 2 : | 100 bytes 
Ir the list aboves the cassette device on the processor 


console is not considered a cerifherat.j Neither the cassette 
feripheral seg@tert nor the magretic tape cr cassette Se geent 
stould be ecoes Gue to the consale Cassettes 


The contrel aonaitaes segment sheuld be added when the system 
is equipped with two or more cisk or tare controls and the 
controls address. the same peripheral urits. | Highspeed 
controls are att disk pack certrots and any controls which 
address phase~encoded tape drives. Under ro conditions is it 


necessary to add any GISMO code segment more than once. The _ 


Dual Processor segment and the B18€0 segwent must both be 
acded if the system is a dual erccessor version. | 


Firaware Trace Space 
This area is allccated orly wher running with trace versions — 


cf the SDL Interpreter. It should never he allocated in oa 
customer's machines. It requires 12440 bits. 


5 


thterrupe dueve 


Since interrupts occur asynchronously on the 81000 systems 
they must be queued until they can be handled by the 


7 appropriate operating > systew routines» One entry tn the 
_ interrupt cueue requires thirty-six bits. Forty-two bits are 
required for opo0inters anc counterse | The. number of entries. 


which may be queued on a given system depends upon the amount © 


cf memory on the systems The number of entries that will ber” 


- allocated may be determined from Ane follaving table. 


” Siena aus ye OS ee 


CSS aE Leek ces Ace ace ces cS SLE cL ABLES Cashak SS SoM ESS LONG ORAS e ae oe a Oar DES So SAO SO SOS ORCA CREO ROT ne EI Se en Se ce cS ER SS 
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Less than 64K awe: oe | _ ee ©: 
At least 64K bytes but tess than 56K eyes : —6©20 
At least S6K bytes but Less than neOK ee | 25 
128K bytes or more | “4 30 


The smallest amount of won that wilt be allocated for the 
interrupt queue is then (42 # (16 x 36) or 616 bits. The 
lergest amount is 1122 bits. 


GISMO Data Space 


The GISMO data space is a work area required by. GISMO. Tt 1s 
a fixed size and amounts to 376 cits. | : 


DCPU CATA SPACE 


Tris is alse a work areas. It is required on alt dual 
processor machines and requires 50 bits. | 


Lookirg now at figure 4.3» the MCP» prior to enacleuine the | 
Clear/Start operations witl allocate. Space for those additional 
items shown on the figure. The location of the “Fence” is not 
important to the discussion cf the memory. requirements of the 


MCP. The ferce is merely a means of guaranteeing that ‘the MCP 


Wilk always find space for its own purposes when such space is 
needece The system would be forced to mat if the MCP could not 
find re space required. bok 


ALL cf the items shown in figure 4.3 reside in Minked: memory. 
One memory tink (187 bits) is required to describe each of the 


items in figure 4.3 


Extenced Result Descriptor Area 


Gre extended result descriptor» 1/0 dec craekor and buf ter. 1s 


required for each 5N head=per-track disk control and for each 


Gisk pack spindle on the systene 9 Each descriptor and its 
associated buffer requires 256 bits. This requirement 
applies to all disk pack drives interfaced to the 81000 
system but: not to cartridge crivese The memory required» in 
cits» may be calculated by ese x CSN controls + disk pack 
anes. + memory Pees = | 
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SDL Interpreter Segaent Dictionary 


The segment dictionary of the SOL Interpreter is ‘considered 
nen-cverlayable» since it conteins a descriptor for segment 

zero of the interpreter which «ust be non-overlayable to 
execute segment zero of the MCP. The size of this area» in 
bits» may be calculated by 64 plus (80 times the number of 
segmwents which comprise the irterpreter) plus the space 
required for one memory Linke The SOL Interpreter contains: 6 
segmentss Bbps. Seerent Zer Oc 


Micro MCP Seguent Dictionary. 


This. ‘segment dictionary is alse cong tdered non~over Layable. 

Its size may be calculated in the same marner as the size of 

the SDL Interpreter segment dictionary» 64 plus (80 times the 
rumber of segments) plus space fcr one memory Linke The 
Micro MCP contains 18 segmerts» plus Segment. eoree The 
— segment dictionary therefore requires. (190 oeytess : 


Queue Disk reaulsee’. 


The MCP reserves 500 segments cof system disk for its own 
temporary use. — The address of this reserved area of disk» 
krown as Queue Diske is stored ir the menory area known as 
the Queue Cisk Templates. This memory area will also contain 
cre bit to denote the availability of each of the £00 
segments» a 24-bit field which will be used to store the 
memory address of the next Cueue Disk Teaptate if an 
additional 500 segments. must be allocated and a 128-bit field 
 krown as the Communicate Splitter Maske This tatter field is. 
' used to determine which com@unicete operations may be handted 


by the Micro MCP. | The size af the initial Queue Disk 
Tenmplete tield is therefore» 5004364244128 or 688 bitse 
Additional Queue Disk Template fields» if required» wilt. 


—eccupy ~S€0-bit areas. One menory ne is required on each 
Queue Disk Template er Rcceteds 7 


Addit ionat Port/Channel Tables 


_— MCP ang GISMO communicate ita number of WaySe One such 
wey is the Port/Chanrel table.- One Pert/Channel table is 
allocated with the SPO variables end buffer at the high end. 


of tinked memoryse If the system is equipped with multi-line — 


ccntrols» an additional Port/Chernet table will be reauired 
fcr each one. | A Port/Chanret table requires 768 bits of 
eROry ere the space Rageanes- fer one men Ory. ee | 


vests SSOP EWS ESS PERERA 20 ET DS SSE RB AS 
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I0AT (I/O Assignment Tabled 


Several items are grouped together in the space reserved for 
the ICAT.j The IQAT itself requires one ertry of 512 hits for 
each peripheral unit connectec to the system with the 
exception cf the SPO. Each disk fack spindte is considered a 


peripheral unite Head-per-track disk is Note Data 
‘ccmmunicat ions devices are not considered peripheral units 
tcr the purpose of calculagtirg IQAT size» but each 


single-lire control connected to the system requires one IJOAT 
entry. Ore “Pause” descriptors» requiring 96 bits of memory» 
is required for each tane coartrotl» -cassette control and 
MIC™“2/MTC"4 exchange on the system. One “Lock” descriptors 
requiring 168 bits of memory» is redquirec for each tape and 
cassette unit connected to the system» Qne I/0 descriptor of 
248 bits is reauired if any rumber of flexidisk units are 
ccnnected to the systeme One mencry tirk is required to 
describe the area containing these items. 7 | 


Port/Channel Tables. spo Variables arc But fer 


on MoE Maer which the MCP needs to penioee its function ahah 
is primarily concerned with the system SPC but also. includes 
‘information on other aspects of the system is maintained in 
the area known as SPO Variables.- This information requires 
1251 bits of memory.~ The Port/Channel table requires 768 
bits and the SPO tuffer requires 560 bits» for a total of. 
2679 bits» One memory link is recuired to describe the area. 


on “SYSTEM DYNAMIC REQUI RERENIS 


The operating system"s dynamic mencry Seauieesents are determined 


solely by the size cf the code segment which performs the 


functions requested by the user in the working set of his 


progreme In determiring this recuirement» it is necessary toa 


know what the program in question is dcings While programs could 


be ahe dre written which have file open and close operations as a 


part. of their working set» this is rot normatly the case. The 
vast majority of programs request only those functions which are 


micrescoded ard included in the Micro MCP in their working set. 


cade» This stétement is not true for Ye pave? use DMS. 


This document will rot present tte memory requirements for 

programs which use OMS. This infornetion will probably be added. 
at some point in the future» but for the present» onty the code 
segmert sizes for operations believec to be ccmmon and exclusive. 

of OMS (operations with be presented. : 3 
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Dee list below presents a brief. description of the tC inetion and 
the penny requirement for each of the Wye re: Bee seqments. 


 SEGMENT-ZERO - 2306 Bytes. 


Segment Zero of the Micro VCP is always required in memory 
when programs are executinge —— , 


SERIAL ~ 1960 Bytes. 


| This code segment handles reads erc writes on serial tiles 
- that are opened input or output but not in any combination 
 fcerms» such as input- output. Also» -some files assigned to 
déta recorders may not require this segmerte 


SEQUENTIAL ~ 762 Bytes 
Tris code segment handles reads rc writes on sequential disk 
files that are opened input~outprt. | | 
RANDOM = 944 Eytes 
This code segment handles reads» writes and seeks on code 
segmerts uhose access mode is rendome This code segment 1s 


required for atl random disk files» even if the access made 
is cevayed nando : 


COMPehAIT = 1136 Sytes 


This code segment is required to handle complex wait. 
ccmmunicate cperations. Alt déta communications hanglers 
generated by the NDL compiler require the complex wait code 
tc be presente | 3 ' 4 » 2 - 


DATASRECOR ~ 244 Bytes — 


This code segment is required te handle reads and writes on 
files which are assigned to cata recorders and which are 
opened inputtoutput or input with stacker selection 
capabilities requested. _ t * | " @ | 


HILPRILAND - 1292 Bytes 


‘This code segmert is requirec to handle all. communicate 
operas tools on ‘files which are ass voned to reader-sorterse 
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QUEUE.READ - 856 Bytes 


This code segment. handles reac and write operations on 


queues. Please refer to the paragraph at the end of this 
List. | | | 


—PQMsGCM = 2674 Bytes 


(Put Queue Message.Get Queue Message). This code’ segment 
handles reads and writes on files assigned to queues and to 


remote files. Please refer to the paragraph at the end of 
this list. : : = | : | 


REMOTEWRI - 2300 Bytes 


This code segment is required to handle writes on files. 
assigned to remote files. Please refer to the paragraph at. 
the end of this List. | = | 


REMOTE.REA ~ 2890 Bytes 


This code. segment handles reads on files assigned to remote 


files. It is also required to handte many NDL/MACRO 
 ccmmunicates. Please refer tc the paragraph at the end of 
this liste | | | | 


DCeINITIAT - 410 Bytes 


This ccde segmert handtes the DCeINTTIATE.IO communicate 
cperationae This communicate is issued by atl data 
 ccmmunications handlers generatec by the ADL compiter. — 


MESSAGE.CO ~ 208 Bytes 


This code segment is required te handte the message count 
ccm@muricate cperatore also issued by ail cata communications. 
handlers generated by the NOL coapiter. 7 | | 


WARTAELE.L ~- 412 Bytes 


- This code segment handles read arc write cperations on tape — 
ard = disk files which use variable-lergth records. It is. 


required in addition to the SERTAL code segment. | Qa 


peas 
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EMULATOR. T = 508 Bytes 


‘This code segmert is required to handle communicate. 
operations requested ky any emulator interpreter on files 
assigned to tape. | | 7 ) 


DELAYED.RA - 592 Bytes 


This code segments» in addition tc the randos code segments is 
required to handle reads» writes and seeks on files whose 
access type is delayed random. Emulator disk files are in 
this category. : . | 


INDEXED.SE - 3020 Bytes 


This seqment is used for I/0 operations on Indexed Sequential 

files» first introduced in the $.0 version of the software 

. ard described in the section cf the document on the I/0 
~Subsysteme = Sea hs | , — 


RELATIVE - 3628 Bytes 


This segmert is used for 1/0 operations per formed. on Relative 
ftles» also describec in the I/C subsyster section. 


TPC.CCOE - 568 Bytes 


This segment 7S ieee ta perfors Inter-Process communication» 
a part of the ANSI "74 CO30L implementation first inctuded in 
the 9.0 software. | | . | 


All code necessary to handle cueuese remote files» the 


DC.INITIATE.~10 communicate and the MESSAGE.COUNT communicate are 
included in. the Micro"MCP.  Micrococing these functions resulted 
ain ‘seme substantial performance improvemerts for most data 7 


communications applications. There are several reasons for the 
improvements the most obvious beirg the greater efficiency of the. 


codee Another factor is that «&¢ miniwal amount of state 


information must be ‘Saved when communicating with the Micro-HCP. 


A third factor is the elimination of the "bottleneck" problem» as 
at has come to be called» for data ccmmunications applications. 


This crotlem arises from the fact thet MCPII is a flat structure 


and is capable of performing one thing at a time only. In other 
words» ance the MCP begins performing an open request for 
examples it can do nothing else until it completes the open. An 


e 
A 
a. 
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vaneie of course» requires many accesses to the disk subsystem and 


the MCP must wait on the completior of each one. Normal~state 
programs are free to execute while the MCP is waiting on each 


access» frovided they do not request er MCP service which must be 
handled MCPII. 


Ecnsecuen vgs user programs may now use the queue subsystem and 
the cther items mentioned above while MCPII is servicing another | 


request for other users. In previcus releases» these same user 


programs had to wait until the MCP coagpleted servicing the 
request it was working on at the tise. Unfortunately» howevere 
all requests for functions in the queue subsystem are not handied 
by the Micro-MCP. Many of thems ard possibly all of thea» way 
stitl be handled es MCPIL. ; 


All memory management functions are still handled by SDL code in 
MCPII. Any queue request which invclves memory management will 
therefore have to be handled by MCPII. This will most often 
occur in situations where the available memory on a system is 


Limited. Queue buffers may be written to disk by MCPIT» and 
hence removed from memory» whenever the MCP needs space _ for 
something elses» This will cause MCPII to be invoked when a 


progrem atteagcts to read @ queue entry from that buffer. 


Further if a producer of queue entries fills an entire buffer 


before the consumer can empty it» a new memery buffer will be 
required. MCPIL will be invoked to accomplish the allocation. 
Unfortunately» in both of these instances» the entire working set 


of Micro~MCP cueue handtirg segmerts will be brought into memory» 


only te determine that SDL MCP segmerts are ready required» This 
can result in substantial performance degradations particularly 
on systemss where available memory is limited. | | 


The situation described can he avoided» of courses by insuring 


that the consumer of queue entries removes them from the aqueue at 


the same rate that the producer enters them. Since it is onty. 
rarely possible for the programmer tc insure that synchronizatton 


existss a System option. has also beer provided in the 61 release. 
which will insure that all queue requests are handled exclusively 


by the SDL MCP. By setting the options the user may insure that 
performance does not degrade when going to the Gel releases as a 
result of the microcoded queue igplementation» though he will 
receive no benefit. tree it. at atl. ae ge we 4 | 


Six new poanents were added to the Micro- MCP to accomodate the 


data communications facilities in the 6.1 release. The new 


segmerts are QUEUE.READ through MESSAGE.CCUNT inclusively. 
Typically» data communication applications which use a handler 


Biles is generated by the NDL Soar, should. consider. pene six 
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ae counts to be a part of their workirg set» poush onty. the tirst 


four cf the six are concerned with tke queue implementation. The 
MESSAGE.~COUNT segment is tnvoked ty the communicate operator of 


the same name and is used to determire whether or not a message. 


exists in the queuese The DC-INITIATE-I10 segwent is also invoked 
by the comaunicate operator of the sase name and should always be 
considered a part of the working set for any data communications 


7 Aron Ucar lens: 


PROGEAM-DEPENDENT SIAIIC SEQUIREMENTS 


The static memory requirements of a programs that memory which is 


required for everything except the pregram’s code» may be divided 


into two classes. Three items which are required are fixed in 


size and the user has no control over theme The user actually 
has tittle cortrol over many of the static recuirements» though 
there are some items which he may cause to varye {tems in the 


latter category are referred to as ccnditional requirements. 


The fixed requirements of the Prograa Static Pewory are composed 
of three components.e These are Llistec be Lows 
Run Structure Nucleus 


This” is a table of informaticr constructed by the MCP when 
the program reaches BOJ.- It is @ fixed size of 2386 bits. 


{ 


Interpreter Segment Zero 


The size of Segment Zero» the non-over Layable segment of the 
Interpreter being used must be determined and added. space 
ner one G@enory Link gust ee included. — 7 


Interpreter Segment Dictonary 


The number of segments in the iiearor (tee sust- be detecaiaed. 

The space required for its segment dictionary is then ten 

bytes times the nuaber of segments plus space for one memory 
Linke c10 x nusber o f segments) 4 ea oe Links 


The. fottoutny are the conditionat - jitess which gust be included in 


the catculation of Reegrae: Dependent cere Requirements. 


Progean Code Seqment Dictionary 


The number. of code segments which comprise the ceca’ may be 


ta 
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determined from the coapiter listing of the program. Code 


segment dictionary space in tytes is then determined ye C10 X 
‘number of i ia + i Link. 


Data Cictionary 


The number of data segments used by the program is known to 
the programmer and is available from the compiler listing... 
The space for the data dictiorzry in bytes is calculated by 
C10 X number of data segments). No memory Link is required. 


Base~ Limit Area also known as Progres Run Structure) 


This number 1s “readily availtabie tiem. ‘the comet ier Listing- 
It is the total data space required by the program (between 


Base and Limit Registers). Space for one memory link must be 
added. = : i 


File Dictionary 


. There is one entry in the file dictionary for each file 
declared in the program» regardless of whether it is ever 
used or note File Dictionary space is given by €10 X number 
af files declared). No memory link is required. 3 


dein, Sataneaetel Block CFIB) space 


This ey ke catculated in bits by: 


1048 x Nusber of MICR Files cpen nlus- 
796 x Number of Printer Files oper plus. 
605 x Number of Remote Files open plus 
796 x Numter of Tape Files open plus. 

1048 x Number of Disk Files cpen plus. 
433 x Number of Queue Files cper plus 

x 


Nugbter of alt other files apen at the time. 


FIB enn Links 
Ore ‘memory tink 1S required for each file that is open. 
Total Butter Space 


The number of and the size of the Sut ioe areas gecertated: 


with each file that is open may te detergired from a compiler 


Listing. This size should be totaled anc added- If the code. 
_ file on disk has been wodified» however» the size given on 
the Listing may be incorrect. |§ True buffer size may be 


Header Dictionaries 
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determined through an MCP keytcard instruction. (Refer to 


B100C Software Operational Guide.) 


I/Q Descriptors 


There is one I/0 descriptor» which requires 272 bits of 
spaces for each buffer in each file that is open. 7 


Disk File Headers 


Disk file headers are maintzined» either in memory or on 
disks for all disk files that are open. If the file is. 
processed inarandom access mocer the header ts naintained 
ir menorye. Otherwise» the heacer is stored on disk and 
brought tnto memory when new disk areas are allocated. Each 
header will require 580 bits plus 36 bits for each area 
requested by the file declaratians regardless of whether of 
not the area is ailocated»s plus space for one memory Link. 
This area is required only when the header is tn meworye 


Cisk file headers are eddressed by the MCP through 
dictionariese- These dictionaries are segmented.j Qne segment 
ccentains. space for ten dictionary entries» Each dictionary 
entry is 2 systea descriptor and requires 80 bits of wmemorye 
The space required for header dictionaries may be calculated 
by C8CO + memory Link? X CCdisk files oper MOD 10) + 1) bits. 


PROGRAM-DEPENDENT DYNAMIC REQUIREMENTS 


To detergine the working set of segments for any program one must 


know where a program spends its time or its “main Line” of 
procedure caitse. The corresponding seg@went sizes must then be 
added up for this main sequence. Segment sizes can be obtained 


from compiler Listings. For RPG precrams» all code segments must 


be ircluded in the working set. For alt other programs the 


compiiers produce a list of code segments and sizese Then the 
working set secments should be lListec and totailed. All segment 


stzes should have 20 bytes added to account for the size of an 
associated memory Linke | | 


As previously discussed» if any interpreter segments are used by. 


the program» these must also be incluced tn the totat. 


on ce a ASA AO ORES oO OO EE A TT —- == =aecd = 
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M=MEMORY MANAGEMENT 


The function of M~memory ‘management. is tc best manage the 


available control memory CM-memory) in a dynamically changing 
envircnment. There are four everts which are able to affect the 
systeg’s demand for M~memory by the introduction or removal of 


interpreters: 


BC 
EC J 
ROLLIN 
RCLLOUT 


Upon the occurrence cof any of theses if the interpreter set 
changeses the new demands witt be evaluated and M-memory 


reallocated. 


One of two allocation schemes will be eaployed: 


DISIRIBUIION 


This method distributes the avatlable M~memcry statically among 


the active interpreters. The size of each portion depends on the 


intercreter's needs» and the available amount of M™memory. The 


portion of the interpreter which is not able to be placed in 


M-meacry remains itn S~memorye As the number of active 
interpreters increases» this alttacation scheme remains in effect 
until further dispersion of M~memcry would result in a severe 
performance degradation-« When this thresholc ts reached» the 
second allocation scheme is put into effect. 


CONTENTION 


This method dynamicatly shares M-memcrys in the form of n_ fixed 
size pages» among greater than fr interpreters contending for. 


these fages. khen an interpreter succeeds tin capturing a page of 
M~-memcry»s the towtorder portion of the interpreter will be copied 


into the page from S~memcry. Hcowevers when the page is 
rewcaptured by another interpreters since there is no mechanism 
for transferring information from #ctmemory to S™memor ye the 
information in that page wilt be tost. Hencee ail active | 


interpreters wust be entirely in S-mewory. 


DETAILED DESCRIPTION 
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1. kKhen anew interpreter is to be brought into memorys the 


3e 


procedure "MeINeWMeOUT" is callece This may be called either 
from BOJ» EOQJ» ROLL~IN» or ROLL-QUT.~ $$The fast entry in the 
interpreter dictionary is first stored in "NIC.LAST.~LOC™. 


Then the interpreter dictionary is searched for entries 


whose usercount is equal to zero (thus no longer in use). 


- Jhese entries are deleted by catiling "¥.CLEAROUT™. 


The previous allocation method is then stored. {f there is 
no MeMEMCRY on the system €8171C series)» then the procedure 
"“NOoM™ is calleds NQ.M examines in turns each entry in the 
interpreter dictionary to ascertain if it is in SeMEMORY or 
note» and if notre the procedure *"DeT0.8" is called to bring 
in the interpreter from disk. The presence bit is then set 
Calthough the systea has no MeMEMORY)» and a pseudo M.MEMORY 
address is calculated and storec in “I[D.¥eADDR". NQ.M then 


exits to MeINeM.~OUT and thence tc the pe veecure wher caitled 
PeTNoMs OUT. | 


Assuming that MeMEMORY does exist» the total minimum number 


Cf MeMEMCFY pages recuired for ail tnterpreters is added to 
that required for CSM» then this total number of pages is 
compared to the total number of Page> of M.MEMORY avaitlabte 
an the ayetees : 


If the total nusber of pages required is greater than those 
availables then the contention sethod is invoked» otherwise 


the distributior methed is invcked. The contention method 


witli be discussed firste For the distribution method» 
proceed to step 6. | 


lhe contention method caiis the procedure "CNTNeSETUP%. 


CNIN»®SETUP first checks to see if the pages remaining after 
CSM is atilecated is Less thar 2» and if so» then all the 

interpreters will be contending for the remaining pages» 
including SDL» and the rrocedure contention is called 
(proceed to step 33. If the nugter of remaining pages after 
allocating CSM is not less than 2» then this number of pages 
is stored in “M.eNUMBER.PAGES".  $YThe SOL interoreter is 
assigned a pages olus any fraction cf a page which may be 


left over. This may occur if CS¥® does rot occupy exactly a 


full page» nora@ally 1024 words. Next» the number of active 


interpreters is counted and this number compared acainst _ 
MoNUMBERsPAGES» If MeNUMBER-PAGES is greater than or equal | 
to the number of active interpreterse then the distribution 


rethod is calied (proceed to step 6).2£ (This could be caused 
ky an interpreter with a very (érge minimus requiresent.) 


The procedure contention first ascertains 1f the SPL 
interpreter is partially restcent in SeMEMORY> and either 


MeNUMBER-FAGES is equal to 1» cr the pcertion of the SDL 
interpreter in MeMEMORY is greater thar the size allocated 
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30 


woh. 


for SDL. If so» then the oracecure “HIL.1T0.S" is calledp 
else proceed to step 4 HIt.10.8 saves the current S.MEMORY 


- address of the SOL interpreter» and stores the disk address 


cf the ‘SDL interpreter in the interpreter dictionary entry 
for SDL. The procedure "N-106.5" is then called to bring in 
the interpreter from disk. De1C.S looks for memory for the 
interpreter» makes the found acdress mods» 16» reads’ the 
interpreter into memory and marks the interpreter dictionary 


entry present. If sufficient femory space was not found» 


then the previous Cpartiat) SOL interpreter is restored in 
S.MEMORY» and adil procedures exited» returning all zeros to 
the procedure which called M~IN.M.0UT. Ctherwise» the new 
copy €complete) is marked not present in MeMEMORY and the 


memory space of the old partial ccpy marked available. 


HIL-702.5 now exits» returning to the contention procedure 


Cproceed to step 5). 


If neither "MsNUMBER.PAGES” is equat to 1 nor the portion of 
the SDL interpreter in MseMERORY is greater than that 
allocated for SOL» and if the pertion of the SOL interpreter 
in MeMEMORY is Less than that allcwed»> then the procedure 


"LK.QUT~MOR™ Gs called to move wore of the SDL neon ne Tae 
fron SeMEMORY to Me MEMORY. | 


The procedure “M.»CLEAROUT™ is then called to clear out of 
the interpreter dictionary att partiaily resident 
interpreterss with the exception of SDL. Each entry in the 
interpreter dictionary is then ir turn examined» and passed 
through the procedure "CNIN.~LOADR™ untit all entries are 
exagined>» at which time contention is exited to M. IN- M.OUT 
Cproceed to step 10). 


The function of the procedure “"CNTN.»~LOADR”™” is to toad 


interpreters either from disk to S.MENORY» and/or from 


SeMEMORY to MeMEMORY. It first examines the interpreter 
dictionary entry to determine shether the interpreter is on 
disk or in SeMEMORY. If it is not in SeMEMORY>» then the 
procedure "0.70.28" is called to bring the interpreter in 
trom disk. lf sufficient memory space is not founds then 
C.T0.8 exits through all procedures» returning all zeros to 
the procedure which called M.IN.M.OUT. "TD.MeADDR™ = and 
"ID.TOPM" are calculated. Eéch interpreter is set up for 
one page of memory. If there is available MeMEMORY lefts 
then the page is overlayed from SeMEMORY to M.MEMORY 
(proceed to step 10). | - 


If the total nueber of pages required is not greater than 
those availabtle> then the distributior method is invokeds 


and the procedure. *PREDISTRIBUTICK* calted. The procedure 


redistribution calculates whether the awount of available 


 MeMEMORY is exactly of a size required ta house the minigun 


fob iS Seve tetee tbe eed eee, Seer D, 


if 2 RLS ERE RS Bip e eee eee aoe ta 


Se Ke sibes 54 SOS St 2h SL a ee a SO a ie a a ee ee 


574 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP : | — B1000 MCP TI 
SANTA BARBARA PLANT | - PeSe 2212 5462 CE) 
requirements of alt interpreters and CSM. If so» then the 


Frocedure “MsGRINDER™ is called passing a value of 1. 


(Proceed to step 7). 


Ctherwises the total amount of memory required to house the 
Raximum requirements of alt interpreters and CSM is 
calculated and compared against the total amount of M.MEMORY 
évailable» and if less than or equal ta the amount of 
MeMEMORY available» then the procedure M.eGRINDER is called» 
fFassing a value Cfield WHICH J of zero proceed to step 7). 


If neither of the above conditicrs is met (that is» neither 


the minigum nor the maximum of all interpreters will fit in 
MeMEMORY) then the procedure “OISTRIBUTE” is called» passing 
a value (Cfield HUH) of zerce The procedure distribute 
stores the maximum available M.~YEMORY» anount required for 
ClMs then if HUE = Qs it initielly assigns each interpreter 
its minimum required space» increments each one in turn by 
cne pages until alt available M.MEMORY is atlocated. If HUH 


= 1» each interpreter's gininun is assumed to be zero» then 
incremented by one page untit atl available MeMEMORY is 


a@ltocateds» The procedure M.GRIACLER is then called» passing 


a value Cfield WHICH) of 2. 


The main function of M.GRINDER is to reallocate MeMEMORY one 


cof three different wayse depending on the values of "WHICH". 
MeGRINDER examires each interpreter dictionary entry in 
turne After having examinec ail interpreters» if there is 
still scme MeMEMORY remaining» then proceed to step 9» 
ctherwise proceed to step 10. | | 


If the entry being examined is rot in MeMEWMORY» or the page 


betng exemired is not the current M.MEMORY page» then 
proceed to step G. Otherwises if the size of this page in 


WeMEMORY is not the size it should be» proceed to step 5B. 


If this M.-MEMORY page is the correct sizes and if the 
interpreter is either partially resident in S.MEMORY or if 


the total length of the interpreter is Less than or equal to 


the amount of this interpreter currently in MoMEMORY Cieees 
the i imterpreter is entirely in MeMEMORY)> © and this 
interpreter is not in S»MEMORY» then proceed to step Ie 


Ctherwise Cthat ise che interpreter. 1s entirely resident in 


SeMEMORY e so the portion of SeMEMORY which was ccpied to 
M.MEMORY must be returned). the interpreter is marked a5 


partially resident in SeMEMORY. If the total length of the 


interpreter is tess than or equal to the amount of the 
interpreter currentiy in MeME¥CRY» then the procedure 
"ALL~oINeM" is called to return the entire S.MEMORY space for. 
this interpreter. Otherwise» the procedure "“LKe.OUT.MEM" is 
calied to return the SeMEMORY srace corresponding to that 


portion cf the interpreter shich has been copied into 


me 
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MoMEMORY. 

8. If the amount of the interpreter in M.MEMORY is tess than 


the amourt allocated in M.MEMORY for this interpreter» then 
the procedure “LK.OUT.MOR™ is called to copy more of the 
interpreter from Se«MEMORY to MeMEMORY 


If this point is reached» ther the appropriate interpreter 


must be krought in from disk. 


The procedure “*M.CLEAROUT™ is catlted to clear out atl 
Fartial interpreters from the interpreter dictionary Cwith 
the exception of the SDL interpreter and atready fitted 
interpreters). : a ‘ | : 


If the current entry in the interpreter dictionary is SDL» 
then the procedure HIL.TO.5 is catled Crefer to step 3. for 
the functions of HIL.T0.5). If sufficiert memory space is 
not found in HIL.T0.S» then exit through alt procedures 
rassing a value of all zeros to the procedure which catted 
MoINeMe-OUT.»j Next» each entry ir the interpreter dictionary 
1S examined tn turn» and if present in S»MEMORY but not in 
*.-MEMORYs then the procedure "5.10.4" is catled tao overlay 


the jappropriate oage from S$.MEMORY to M.MEMORY» and to 


return either the entire SeMEMCFRY space occupied by the 
interpreter or else to return only the portion overlaid. 
Each entry in the interpreter dictionary is once again 
examined in turns and if the presence bit is set» proceed to 
step 10. . 


Tf the presence hit is not set» then the procedure D.T0eS is | 
called tc hring in the interpreter from disk to memory 
Crefer to step 3 for a description of D.T0.5).- If 
sufficient memory is not fcurnd in OeT0.5» then att 
procedures are exited» passing 2 value of all zeros to the 


procedure which calted MoIN.~M.OLT. | 


The procedure S~T0.M is then cailed (see description above). 


At this point» the allocatior wethod Ceither distribution or 
contention) has been decided eérd executed» and ccntrot — 
passed back to MeIN.M.O0UT. — | 


If the new allocation method chesen was successful» and if 
the new allocation method is the same as the old onep 


rroceed to ster 11. Tf the new method is distribution | 


€(therefore» the old was contenticnd» then the procedure 
FELEASE.AeSEG is calted to mark the MCP segment FEIN-STATE 
evailable Creset save bit in the memory Link). If the new 
@ethod is contentions then the procedure SAVEAeSEG is 


called tc mark the MCP segmert REIN.STATE saved (set save 
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bit in the memory Link). 


If the value passes to Ms.GRINDER CWHICH) was O or 1. Then 


return from M.GRINDER through redistributians to MeINeMeOUT. 
If the value passed to MeGRINDER CWHICH) was 25 then return 
from MeGRINDER through OLSTRIBUTE to REDISTRIBUTION» to 
MeINM.OUT and thence tc the procedure which catled 
MoI NeMeOUT. | - 4 
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PROCESS (PROGRAM) FANAGEMENT 


Viewirg the MCP as &@ manager of processes emphasizes its role in 
the management of job execution. That part ef the MCP concerned 
with such manacement may be termed the “precess controller”. 
While the process controiler is not a distinct module in the MCP» 
it is a convenient term to describe atl those distinct functions 
whichs. taken together» form a cenceptual package. Certain of 
these functionss namely “ROLLIN'» “"ROLLOUT™>» "CAUSE "» "HANG 
PROGRAM» are best understood within this context and will be 
Giscussec in deoth in this section. 


The actual execution of programs» the allocation of processor 
time to processes which are ready tc execute and ares therefore» 
in the Ready Gueues is accomplished by micro code contained in 
GISMG known as the “Micro Scheduler”. The Micro Scheduler is a 
part of the process controller. The Micro. Scheduler 1s 
resporsible for the aklocation of alt processor time on atl 
processors which may ke attached to the syster. 


The process controller is driven by the occurrence of certain 
softwere evertss called “soft events"» which can be identified 
and anticipatec by the MCP. When a process submits a request to 
the WCPse the orocess may or way not te reaquired to waite if a 
wait is necessarys the MCP is able te anticipate the event upon 
which that process must waite Thus the MCP car tabel the job as 
waitirg for sage “soft event™» susnerd the job by placing it in 
the “wait queue"» and continue to execute its other duties.» When 
the scft event “happens*”» the Micro PCP can search the watt queue 


to discever the process marked waitirg for the happening of that 
event. 


The “FANG PROCRAM™ functions which claces programs in the wait 
queues and the “CAUSE" function» which takes programs from the 
wait cueues are crucial. Soth furctions must be cognizant of the 
s4me soft events. “HANG PROGRAW" is responsible for creating a 
unique bit string which will represent the soft event for a 
processe On the other end “CAUSE™ must have the proper soft 
event generated for it» so that the waiting process can be 
located. 7 


The wain asset of this method of erecess manipulation is to free 
‘the MCP from waiting for the completicn of I/0 cperationse I[t is 
able te iritiete a recuested operaticr and to incependertly match 
a soft event with its corresponding pracess at a future time when 
the pence gn has beer coe heeds 
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The process controller recaives inputs from two sources? an “I/0 


DEVICE" of a “CONTROL DEVICE™. Both way affect processes in the 


system. User demands upon the system are submitted through a 


contrcl device which way accert only control Language statements. 
On the B1000» the supervisory printer (SPO) may only be used as a 
contrcl device. The card reader way te dynamically assigned as a 
control device or an I/0 device. ALL cther peripheral devices 
may be used as I/0 devices onlye In acdition» a program may act 
as a coantrot device by sendirg a ccmmunicate to the MCP which 


contains a control Language statement. See “PROGRAM 
COMMUNICATES*™. 


Control Language statements» of direct interest to the process 
contrctlers may be divided into three categories: 


€1) Statements which generate a sceft. event (Ceege» allow a 
suspended process become active» direct a process to a 
reripheral device) i 


(2) Statements which cause job suspension 


se?) Statements which request job execution and provide alt the 


aperepEiare parameters 


If the control language statement requested that a job be 


executeds the "Control Language Processor™ directs that the job 
be scheduled. Briefly» the scheduling function involves placing 
it in the “schedule queue" but allocézting no machine resources. 
In the MCP cuter Loop» the schedule queue is periodically 
checkede and the first job in the queue is initialized. 


"Prograa Initializatton™ involves allocating the machine 
resources and setting up the structures necessary for program 
execution. fnee the job has been initialized» it is placed in 


the "READY QUEUE" to await actual execution. 


Once a program has been initialized» it will move in and out of 
six pessible states during the course of its tife in the system: 


READY QUEUE 
COMMLATCATE CUEUE 
WAIT QUEUE | 
NOT CUEVUED» EXECUTING 
NOT GCUEUED>s COMMUNICATE BETAE ANALYZED 
M COMMUNICATE QUEUE 


SE Nee renee 
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The ready queue contains jobs which sc fees ‘6 ‘Tune The 


cammunicate queue contains jobs which have requested some MCP 


function. The wait queue contains jcts mlwen are waiting for the. 
map aera of a “soft event”. _ 


The ‘queuing mechanisn is managed as tcllows. ALl run structures 


are tinked . Reh gied by priority. A field in the run structure 


nucleus» Qe IDENT» specifies the current state of the 
processe the first member of a queue car thus be found by 
searching the linked list of run structures until the proper 


value in RS-C.IDENT is found. 


A job waiting in the ready queue represents a demand. for 
processor time upon the system. This oueue is interrogated by 
the Micro Scheculer. If a job is feund» the reinstate functions 
which is performed by the Micro Scheduler in GISMO» is called in 
preparation for turning the processor over to that job. Briefly» 
the reinstate function performs certain housekeeping duties and 
causes a processor to begin execution of that jab. 


The program will execute until one of three things happen: 


€1)_ The program's interpreter disccvers an interrupt which 
requires the MCP*s attention. © 


(2) the program needs some MCP service performed before it can 
continue 


€3) The master processor instructs the slave to idle. 


In any case a communicate message is buitt in a field catted 


RS-COMMUNICATE.MSGePTR in the prooraa's Run Structure Nucleus and 
contrci is passed back to the Micro Scheduler. 


The contents of RS»COMMUNICATE.MSG.PTR» analyzed by the 
“communicate handler“ in the Micre Scheduler» specifies what 
action is to ke taken upon the orografe In the case of (1) 


above» the sessage will simply contain a recuest to be put back 


in the ready cueuee (The Micro Scheculer then returns to its 
outer Loop where it independently discovers the INTERRUPT.) 


A request for service €2) may or way rot require that the program 
wait for the happening of some soft event. If the request can 


immediately te serviced» the Micro Scheduler does so and places 


the jeb back in the ready queue. If the program must waite 
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however» the "HANG PROGRAM" function is called. 


"HANG PRCGRA¥™ puts the jokt in the wait queue and tabels it as 
waiting on the appropriate soft event. Depending on the’ reason 
for the wait» the program may or way not be “rotied out". The 
"ROLLCUT" function will copy all hut a certral core of the 
program*®s Run Structure Nucleus te disk. For a detaited 
discussion of these functions» see their respective sections 
belan. - | | 


The program witl remain in the wait queue until the event upon 
which it was waiting has been “causec" The soft event upon. 
which a job must wait may come from three basic ‘sources? 


Ci) 1/0 interrupts. 
(2) Control language statements 
(3) MCP 


I/0 interrupts are “hard events" which nust be transformed into 
soft events before they may be associated with a processe A hard 
event is any asynchronous occurrence in the hardware of which the 
software must be cognizant. The occurence of such a hard event 
is usually manifested by a flag in the processor. The function 
of "1/0 COMPLETE" is to transform these hard events of interest 
to a process into its corresponding soft event. 


Some control Language statements will cause the control language 
processor to generate soft events. Such statements signify the 
happening of some event a process might be waiting for Ce-ge» 
FAX" >» "TIL"5 "UL"» "GO"s and “OK"). 


Other soft events are generated internatly by the MCP. For 
exauples prccesses waiting on a nocmemory condition or a parent 
program waiting for the tersinaticn cf a nested program must be 
notified when they are able to resume processing. The MCP 
generates suck soft events. | | | 


At the point when the soft event has heen generated (Cfrom 
whatever source)» ane can say thret the “event has happened”. 
This soft event is used by the Micra. Scheduler function to locate 
the. corresponding process in the wait queue. 
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If the process is in memory Chad not teen rolled out)» the Micro 


Scheduler analyzes the reason that the process had been waiting 


to determine whether or not the Last communicate was completed. 


If it wasp the job is put in the ready queue to await 


reinstatement. If the communtcate was not completed» the job is 
put ir the communtcate queue to wait for the reinittation of the 
commuricate by the communicate hardler. 


If the process was not in memory ard memory is available» then 
the "ROLLIN" function tis calleds Its duty is to reestablish the 


fun. structure that had been "rolled out" to disks The reason for 


waiting is then aralyzed tin the same manner described abovee Lf 
there was no memory available fcr rollin» then the job is put 
back in the wait queue to wait for gemorys The wait reason will 


be ugdated to reflect this status change and to specify into 


which queue the job would have gone tad memory been available. 
When wemary becomes available» the jot wilt ke put directly into 
the specified queue. | “4 7 | 


The process will continue to be manipulated ir this fashion until 


it has completed execution. At that time it will request the 
end-of=job furction from the MCP and terminate. | | 
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MCP CUIER LOOP 


The MCP can be viewed as a orograr ubose sole duty 3s to respond 
to dewands aade upon it by the systea. This seemingly innocuous 


statement is velid even though the MCP is a vastly complex 
prograte The complexity arisese howevers by virtue cf the 


diversity of demands to which the MCP is able to respond. 


There are five basic categories of demands to which the MCP 


initiatly responds. These categcries are recognized at the 
outerwost or wost global level of tte MCP. which iteratively 
searches for each. Once a demand is founds it is analyzed at 
increasing levels of detail ard resolved according to its 
specific request. Control is then returned to the auter loop 
which continues to search for demands. ; | 


The five types of demands recognized ty the MCP*s outer loop are 
described belcou. 


TIMER INJERRUPI 


The first tyre of demand recognized ty the MCP is called a timer 
interrupte there are two fields in the MCP*s globat data space; 
A software maintained system clock ard a clock maske Every tenth 
of a second an tnterrupt is caused ty the hardwaree «© GISMOD 
detects this interrupt and buaps tre system clocke Every time 
the MCP begins its loop searching for demands» it checks to see 
if the vatue of the system clock has exceeded the value of the 
clock maske If it has» the MCP cails the "N.SECOND” routine to 
perform its housekeeping duties ard resets the clock mask to some 


value greater than the system clocks See "N»SECOND routine”. 


140 INIJERRUPIS 


An Isc interrust is 42 soft mechaniss ty which GISMO notifies the 


MCP that an I/0 operation is complete. GISMO will only do so. 


when the MCP reaquests that it be notified or when an exception 


condition has cecurred on the I/0 aperatione. This should not be 


confused with a “service request" type of interrupt. This 


service request is a hard tevel in the processor and is used to 
notify the software that a hardware I/0 control is in neea of 


servicea : 
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The WMCP witil request notificaticn of the occurrence of I[/0 
comoletion onty when there is a need for it tc know. The MCP 
does not reocuest the return of I/C complete interrupts on user 
I/O cperations unless the program which caused the operation to 
be initiated is waiting on the I/0 operation. This is discussed 
further tn the sections of the specification covering REA and 
WRITE. 


When an I/0 operation is completed» GISMO stores the result 
descriptcr associated with the operaticn tin its proper Location 
in memory. The field is known as the "result descriptor field" 
and 18 a part of the actual I/0 descriftor. There is an area 
allocated in memory «known as the interrupt stack» which is 
actuaily a queue of I/0 complete iirterrurts. —~GISMOs. after 
storirg the result descriptor» if the interrupt request bit in 
the descriptcr was one stores the address of the result 
descriptor in the interrupt stack anc “causes” the MCP» if it ts 
waitirge In its outer loop» the MCP requests that GISMO deliver 
the address on the top of the interrupt stack. Tt analyzes the 
descriptor at that address and takes the apprcpriate actione The 
MCP continues to frequest addresses from GISMD in this fashion 
until the stack has been exhausted. | 


Upon receiving a descriptor’s address from GISMO» the MCP invokes 
a routine called “IQ.COMPLETE™ to begin the aralysis- Depending 
on the value found in a field cf the result descriptor» 
IQO.COMPLETE tnvokes one of the folloxing MCP facilities» each of 


which is discussed in depth» on the fcllowing pages. 


CAUSE MECHANISM CSEE "PROCESS MANAGEMENT") 
CONTFCL LANGUAGE PROCESSOR 

IGAT MAINTENANCE 

I/0 ERROR HANDLER 

SPO MAINTENANCE 


JOG SCHEDULING AND INITIALIZATION 


After exhausting the interrupt stack» and if an MCP —globats | 
"CHANCEUIT"» is trues the MCP checks the “schedule queue” to 


determine if any jobs have been scheduled for executione 


CHANGE.BIT will be false whenever a previous attempt at program 
initialization failed because of insuffictert memory» and nothing 


has intervened to create a possibility cf success at this. 


attempte The program initializaticr routire sets CHANGSE.3TT to 
zero (false) whenever an initializatior fails. It is set to one 
(true) whenever a block of memory is freed by job termination or. 
"rollcut"» whenever a new job is plzced at the top of the active 
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schedule» or whenever explicitly set ty the “PS* control language 
Statements The MCP is thus able ta aaximize its own resources by 
bypassing a futile attempt at job tritialization.~ | 


The schedule Queue contains an active and a waiting schedule. 


Both are Linked lists on disk which contain those jobs awaiting 
execution but for which no memory resources have yet been 
allocated. The control language processor identifies a request 
for a job to be executed. It huilds a tog ertry Csee “LOGGING 
INFORMATION") for that job and tirnks it by priority and time of 


request to other jobs waiting to be itrittalized. See “CONTROL 
LANGUAGE PROCESSOR” for exact specifications. The active 
schedule lists those jobs that are ready to rune The waiting 


schedule contains those jobs whose iritialization must await the 
occurrence of some event Cisee» the terminaticn of another job or 

operator control message). Hhen the event happense the job ts 
transferred from the waiting schedule to the active scheduler 
where the MCP will find it. 


The CP selects the first job ir the active schedule for 


initialization. once the job has teen denmqueued» controt iis 


passed to the "program initializer” which allocates the machine 


resources and sets up the structures recessary for the program's 


executione 


COMMUNICATES 

A program may request certain services from the MCP. These. 
requests represent another class cof cemands tc which the MCP must 
resporde Tre "communicate queue™ contains jobs which have 


Submitted such a request. 


The queuing mechanism is managed as follows. Each run structure 
nucleus contains two fields? “"RS.COMMUNICATE.MSGePTR” which is a 
Standard @essage area and “RS~Q.IDENT" which specifies in which 


queues if any» the program ise The value of RSeQe-IDENT may be: 


Q = READY QUEUE | 
1 = COMMUNICATE QUEUE 
11 = WAIT QUEUE | 
“2 = NOT QUEUED Ci.e-» running) 
10 = MMCP COMMUNICATE QUEUE 
3 = EXTERMINATE QUEUE 
Atl run structures are tinked together by prioritys Thus the 


members of a civen queue may be discovered by searching the 


linked List of run structures and checking RS-QeIDENT. 
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The first job in the conmunicate queue is serviced according to 
the ccntents cf RS-COMMUNICATE~MSG.~PIR.~ The message is initiatly 
analyzed by the communicate message handling routine which calls 
the proper subroutine to further analyze the wessage and take the 
appropriate action. The proper sutrcutine is determined by the 
first two bits of this message aree called “"RS»«ITYPE”. The 
values and corresponding meanings af this field are as fcllows: 


INTERPRETER GENERATED COMMUNICATES 


00 = 
01 = PROGRAM GENERATED COMMUNICATES 
10 = UNDEFINED | 
il = 


FILE CLEANUP COMMUNICATE 


Interpreter generated com@unicates contain requests from the 
program's interpreter for services which are unrelated to the 
program"s codee These include requests for missing segments» 
trace and run time error aeSsege=? etc. 


Program generated communicates are requests fer code related 
services suck as I/0 operations. These are specified under 
"PROGRAM COMMUNICATES". | 


The file cleanup communicate is an MEP generated cogmunicate used 


in conjunction with program end~of~jch. 


PROGRAM REINSIAIE 


To be speci fied. 


PROGRAM COMMUNICATES 


Ait cbhject programs communicate sith the MCP by means of a 


Commuricate S-operator. The operatcr serves to transfer control 
frog the user's interpreter tc the MCP *s. Though many 
comBunicates are now handled by micrc-code in the Micro-MCP» the 
means of communication has not changed.e. The compiler generates 


goede which establishes an area in the progras's run structure. 


This area generally conforms to a standard format which is 
recegrizable ty the MCP. The fields in this area are defined. 
arbitrarily» howevere Onty the first twelve dits of. the field 


_ Rust conform tc the format presented below. 
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COMMUNICATE FORMAT 


VERB o~ 11 
OBJECT i2-7- 35 
ADVERB 3€¢ ~ 47 
CT.1 4@ - 74 
CTe2 f72—- 95 
CT. 35 $6 = 119 
CT.4 120 - 143 
CT.5 144 ~ 167 
CT.6 168 ~- 191 
CT.7 192 ° 215 
CT.8 2ie€ 239 
CT.9 240 - 263 
CT210 264 - 297 
CT.11 298 ~ 321 
CT.12 322 = 345 
CT.13 346 ~ 369 
C1214 370 = 393 


Nete: All communicates return a2 value of 2000000000000¢2 or 
aCCOOLT8BCQUCN00d in the RSeREINSTATE MSG. PTR untess 
otherwise specified | 


All interpreters» when executing the Communicate S~operatore 
store a pointer to the reserved» fcermatted memory area in the 
field called RSeCOMMUNICATE.MSGePTR of the RS-NUCLEUS of the. 
progréem heing executed.» This forty eight bit field specifies not 
only the relative address of the coggunicate area» but also the 
size cf the area in bitse For further information on this aspect | 
of the operations refer to the prograawatic description of the 

Run Structure Nucleus. 


‘If the MCP needs to convey informaticr back te the object program _ 
after executing the requested communicates it does so by setting — 
the field cailed RS»REINSTATEsMSGPTR to a selected value» If no 


information is to be conveyeds this field is set to either 
200000000008 or 20000180000003 befcre reinstating the program. 
Other values» and their associated seanings depend upon the type 
of ccmmunicate teing executed» ard are described for each 
communicate in the sections which followe | | 
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ILLEGAL COMMUNICATE 


READ Culecrg MeP) 


CTeVERG ~— OL 
CT-CBJECT FILE-NUMBER 
CIeADVERB BIT 


0 REPORT & RETURN 170 USER ON EOF 
1 REPORT & RETURN TC USER ON PARITY 
2 REPORT & RETURN TO USER ON INCOMPLETE I/0 
3 LENGTH ADDRESS PAIR IS PRESENT FOR RESULT MASK FIELD 
rf STACKERS“-STACKER # IS IN CT.3 
~ | @-ii - | 
CT.i LOGICAL RECORD BIT LENGTH 
_ CT.2 “LOGICAL RECORD BASE RELATIVE BIT ADDRESS 
CT.3 RANCOM FILE ACTUAL BINARY DISK KEY 
CRECORD NUMBER INSERTED BY MCP FOR SERTAL FILES) 
GR 
- LENGTH OF KEY FOR REMCTE FILES | 
' CT.4 ADDRESS OF KEY FOR REMCTE FILES CNLY 
i CT.5 LENGTH IN BITS OF RESULT MASK © 
: CT.E EASE RELATIVE ADDRESS CF RESULT MASK FIELD 
: REINSTATEMSG-PTR VALUES 
' Si 0 GO0D READ 
‘ 1 END OF FILE 
a Z I/7CG ERROR 
Pe, F 3 | 3 INCOMPLETE I/0 
i 4 IMPOSSIBLE SEARCH CRPG SEARCH oP) 


7 A READ communicate on the 81000 System serves to deliver a 
bo iogical record te the user program. It does this by moving the 
| record from the I/0 buffer area in memory» where it was 
a previcusty stered by the CSM» tc the user’s Run Structure 
i, CBase/Limit) area. In atmost all cases» the READ» WRITE and SEEK 
_- commuricates are perftorned by the Micro~MCP. This has been true 
— since the Sel release of the software. | 


_ ss The information passed in the communicate area must include a 
bo unique file nugber. This number is assigned by the compilers. and 

: $8 passed to the MCP in CT.OBJECT. The same statement is true — 
for all communicates which deal with an I/0 operations such as 
WRITEs SEEK» OPEN» CLOSE» POSITION ard so forthe 


The ccamunicate information must alse contain the base~retative 
address of the memory area where the record is to be stored and 
the tength» in bits» of this area. These items are passed in 

CTe2 end CTe 1» paveS Cre: _ 4 : 


i“ 


BURRGLGHS CORPCRATION | COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP : oe 81000 MCP II 


SANTA BARBARA PLANT es. | Pe Ss 2212 5462 CE) 


Logicel record size is contained in the FPB» which is constructed 


by the compiters from information contained ir the user's file 
declaration. In the case of variableslength recordss togicatl 


record size may be contained in the record itself. The length of 
the user's “work area*» contained in CIe-l» does not have to be 
equal to the logical record size. If CT.1 is larger than logical 
records Sizer the movement to the work area wilt occur 
left-justified with blank filt on the right. If CT.1 is smattler 
than togical record size» truncaticr from the right will occur. 
in the Latter case» inforwation will be lost from the low-order 
postions of the record. 


For a@ sequential file» the ‘ecord delivered wilt be the next 
recorc in sequence in the files. For a random disk filer — the 
recorc to be moved is snecified ty the birary number in CT.%. 
Record numbering in a random file on the B1000 system begins with 
ones ky defiritions regardtess of the source language which the 
user program is written in. A zerc passed in CYT¥.3 will he 
considered invalid by the NCP and tke appropriate action witl be 
takene , | 


If the user program included code te be per formed when the end of 
the file is reacted or» in the case cof randon files» when CT.3 


| specifies aonurgber which is beycnd the end of the fite or 


describes a record which has not yet been written or is otherwise 
invalid» the specified bit in CT~ADVERE should be turned on. 


if the user program included code to te performed uhen an 1/0 
error occurs and canrot be ccrrectec by the MCPs the proper bit 
in CT»ADVERB shoulda be turned one If control is returned to the 
user in this case» if the bit in CT.ADVERB ts ore the user’s work 
area wilt contain the record which was read erroneousty»j In this 
case» nothing in the work area shoulec be assumed to be valid. 


Ordinarily» when a user requests a logical record :-and the 
associated physical I/0 operation is not yet completers the 
program %?s not allowed to execute until such time as the 
requested record can be delivered to his work area. For 
sequertial files» I/0 operations tc fill atl of the I/0 buffer 
areas assigned to the file are initiated when the file is opened. | 


The PCP attempts to stay ahead cf the user program from that 


points tnittating a new [/0 cperaticn to pre- Fill each etl as 
soon 2s it is emptied by the user prcoram. 


For scree Data Communications apolicaticnss it is not feasible for. 
the user program to wait until a requested I/C completes. Ife 


for examples the program is reading cards and the card reader is 
not ready» it may be a tong time until the operation completes. 


For such programs» the third bit in CT-ADVERB is used. Setting 
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‘this bit causes the MCP to return control to the user programs 


regardless of whether a record was delivered or not. If no 
record was delivered» the program is informed cf the situation by 


setting proper values in RS-REINSTATE»MSG2PTR.» This is discussed. 


in more detail tater in this section. 


Remote files may consist of more than one data communications 
termiral. In such a case» it is necessary for the object program 
to specify the identification of the terminal it wishes to fread 
frog. §§This is accomplished by setting CT.3 and CT.4 to the 


proper values. 


In ail three of the cases described previousty» where bits one» 
two or three are set in CT.ADVERB» it is necessary for the MCP to 
inforn the user program of the existing condition. This is 


accoerplished ty setting a field in the RS-NUCLEUS to a specific 


value prior tc reinstating the prograés. The field is defined as 
REsREINSTATE2MSG-e-PTR and is accessed by the users interpreter as 
soon és it 1S reirstated» after doing a commuricate. Tf a valid. 
record was delivered to the users the message field is set to a 
value of zero. It will te set to cre» twe or three if the 
respective bits are on in CT.«ADVERB ard the condition assigned to. 
these bits exists. | | : 


If a user program READ communicate encounters an end~of-file 
condition and bit ore in CTw«ADVERB is not sets» the program witt 
be discontinued by the MCP. If a user I/0 operation results in 
an irrecoverable error and bit two is not set in the READ 
com@uricate which requests the reccrds the program will be 
discortinued ky the MCP. if a user program requests the data 
from an I/0 operation which is not yet complete and bit three of 
the edverb is not sete the orocras is merely forced to wait for 
the I/G completion. | | 


For tiles which are assigned to Data Recorders and other selected 
card Input/Output devices» the user tay specify that the card 
which was read is to te routed to a certain physical stacker on. 
the device. This is accomplisnec by setting the specified bit in 
CT-ADVERB to cne and by setting CT.~3 to the binary number which 
desigrates the nhysical stacker. Ir this case» there is never a 


need for more than one buffer area tc te assigned to the file» 
and the MCP OPEN routine will prevent this from happening. Card 


I/Q cperations in this case are not “buffered™ and. card 


throughput will decrease accordingly. 


For randos disk files» a READ comauricate gay not result in an 


I/0 operation being initiated. If the user who does the READ is 


the sole user of the file ano if the block which contains the 


- requested record is aiready in memory in one cf the user*s buffer 


A 


areas» 
area. 


CT.VERB 


WRITE 
similar to READ. 


the 


requested 
This action 
user cf the file. 
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will be simply moved to his work. 


if there is 


more 


than 


one 


02 | 
CT~CBJECT FILE~NUMBER 
CT.ADVERE BIT | 
Q REPORT & RETURN JC USER ON EOF 
1 REPORT & RPETURN TQ USER ON PARITY 
Z REPORT &8 RETURN 10 USER ON INCOMPLETE I/08 
3 LENGTH ADDRESS PAIR IS PRESENT FOR RESULT MASK FIELD 
4-5 - | 
6 QUEUE FILES? WRITE To FRONT ‘OF 
GUEUE C™STACK"). 
7 STACKERS=~STACKER # IS IN CTe3 
8-11 PRINTER SPACING (C4 BIT VALUE) 
C NO PAPER ADVAACE | 
1 SKIP TO CHANNEL 1 AFTER PRINTING 
2 SHIP TO CHANNEL 2 AFTER PRINTING 
3 SKIP TO CHANEL 3 AFTER PRINTING 
4 SKIP TO CHANNEL 4& AFTER PRINTING 
5 SKIP TO CHANNEL 5 AFTER PRINTING 
6 SKIP TO CHANNEL 6 AFTER PRINTING 
¢ SKIP TO CHANNEL 7 AFTER PRINTING 
8 SKIP TO CHANNEL 8 AFTER PRINTING 
9 SKIP TQ CHANAEL 9 AFTER PRINTING 
A SKIP TO CHANNEL 10 AFTER PRINTING 
B SKIP TO CHANNEL 11 AFTER PRINTING 
C SKIP TO CHANNEL 12 AFTER PRINTING 
D SKIP TO TOP OF FORM C1500 LPM PRINTER ONLY) 
E SINGLE SPACE AFTER PRINTING | 
F DOUBLE SPACE AFTER PRINTING 
ae te | LOGICAL RECORD BIT LENETH 
CT.2 LOGICAL RECORD BASE RELATIVE BIT ADDRESS — 
CT.3 RANDOM FILE ACTUAL BINARY DISK KEY 
CRECORD NUMBER INSERTEC EY MCP FOR SERTAL FILES) 
OR | 
a LENGTH OF KEY FOR REMOTE FILES 
CT.4 ADDRESS OF KEY FOR REMCTE FILES ONLY. 
Cte5 LENGTH IN BITS OF RESULT MASK - 
CTo€ EASE RELATIVE ADDRESS CF RESULT MASK FIELD 


REINSTATE. MSCaPTR YALUES 


C GOCD waite 

1 ENC OF FILE 

2 I/C ERROR 

3 INCOMPLETE I/O 


communicate on in a manner 


logicai -record 


the #810CG system operates 
The user program constructs a 
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somewhere within its Run Structure and communicates with the MCP. 
The MCP will then move the data from the work area» the address 
and tength of which are described ty CT.2 and CT.1 respectively» 
to the next available I/0 buffer areé. The program will he 
allowed to continue as soon as the novement of the data occurs? 


at is not forced to wait for completion cf the actual I/0 


operatione 


As ir the case of the READ communicate» either blankfill or 
truncation of the rececrd will occurs depending upon the sizes of 
the werk area and the file's togical record. The buffer will be 
released» which means that the corresponding I/0 operation will 
be  irititiateds as scon as the buffer area has been fitted to 
capacitye A program is forced to wait for I/0Q completion if the 
MCP cannot find an available buffer to which it can move the 
recorc. A buffer is unavailable if the previous I/0 operations — 
which may have been initiated some time agor is not yet complete. 


End~cf"file is not reported to a user cn an output file except in 


the cases of disk files and some printer tiles. End~of"file for 


a disk file is defined to he an atteart by the user to write past 
the aeclared size of the file. The declared size of alt disk 
fites ts maintained in the File Header» a permanent entity 


created when the file is opened output for the first time. 


For files assigned to printers» end-of~file may be defined to he 
the sensirg by the hardware of the ptysical erd of the page. In 
ali casese this is not actuatly the end of the page» but rather 
the sensing of a channel twelve furch in the Carriage Control 


Tape. This sensing will be reportec to user programss i f 


requested by setting bit one in CT~ACDVERB and by setting a bit in 
the FPB for the file. Notice that» tecause of the fact that the 
MCP is examining the result of I/0 oferations which may have been 
initizgted some time ago» end-of-page is not reported when it 


occurs» but "n" write operations laters where "n" is the number 


o f buffers assigned to the file. 


I/O errors are also reported to user programs on the WRITE 


 commuricates Vf requested. This information is necessarily of 
little practical use» or any &urroughs operating system. 
Ostensibly» the I/C error routires of the MOCPCsS) should be of 


such a nature that the need to report this occurrence never 
aAriSeSe | 


The same Data Communications applications which use bit three of 
the adverb on REAL» use it in a siwilar manner on WRITE. When 
using this bit in the adverbs cortrolt is returned to the user 


when 2 WRITE is requested but the buffer that should be used is 
not yet available ta the MCP. Agaire this can be caused by the 
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device itself going not ready. 

Printer spacing information must be rassed to the MCP on each 
WRIYE communicate for 42 ftle which is assigned to a printer. 


This is accomplished by setting the praper bits in the adverbs as 
pictured in the preceding. 3 3 


Serial disk files may be opened by the user program for both 


input and output operations. In cther words» the file may be 
openec in such a manner that both a READ and a WRITE communicate 
are acceptable» with no intervening Close and Open. When this 


type cf OPEN ccmmunicate occurse the MCP wild pre-fill atl of the 
buffers» as if the file had been opened INPUT only» but the 
buffers are reteased at different points ir the READ and WRITE 
comsuricate processing. = 


The MCP will ret move buffer pointers at the corclusion of a READ 
com@uricates as it normatly does. Instead» it must wait until 
the next communicate operator asscciated with that file is 
received. If the succeeding communicate is a WRITE» it will wove 
the data from the work area to the buffer and change the 
operation cace in the 1/0 descriptcr to a Write. Tt will mark. 
the program “ready to be reinstated"» and then rotate the buffers 
in. anticipation of the next comgunicate operator. In this 
specification» the term “rotate the tuffers”™ weans that the MCP 
moves the necessary buffer pointers and initiates the I/0 if 
necessarye. : | | 


If the next communicate received at this point 1s a WRITE» the 
MCPs after. insuring that the next tuffer is available for uses 
will wove the data again» from the work area to the buffer and 

rotate the buffer pointers. If the communicate had been a READ» 
the MCP would have moved the data ir the oppecsite direction and 
it would not have rotated the buffer pcinterse. | 3 


In summarys for this type of file» twe successive READ operations 


will wove two successive records fro the file to the user's work | 


are@ade Two successive WRITE operations will cause two successive 
records to be written into the file. A sequence of operations 
such as REACD*WRITETREAD“WRITE wilt cause twe successive records 
to be delivered to the user and the same records»s but not. 
necessarily the same data» tc ke written in the file. The 
End~of"File pointer for a sequential ree may be -.extended when 
or file is opened in this manner. : oe 


Disk fites which contain variable-length records. may not be 
opened for both input and output operationss cr for random access 
processing. | 
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For Sequential I/0 fites» a physical. {1/0 operation is not 


necessarily initiated each time the user oregram does a WRITE. 
For blocked files» if the user has core a WRITE on any record in 
the block» the operation wiil be iritiated orly when the  huffer 
pointers are moved past the end of the block. : 


‘For data communications files» the fields described as CT.3 and 
CTa4 gre used on WRITE communicates exactly as they are on READ 
com@muricates. - : 


For réndomw disk files a WRITE commuricate may result in more than 
one physical I/0 operation. If the file is tlocked» the block 
which contains the requested record sust be in a buffer in memory 
before the reccrd is inserted in the tlock and actually written. 
to disk. This. is due to the fact that the hardware can onty 
initiete I/0 aperations and termirate them an segment boundaries. 


If the bBtock which contains the requested rececrd is not in memory 
when the WRITE is issued» the MCP will initiate a Read operations 
force the requesting user to wait for its cogpletions move the 
recerc into its respective positicn in the block after the 1/0 
completes» altow the user to he reirstated at this point = and 
initiate the requested Write cperation» if the file is being 
accessed in the RANDOW mode. | te : 


In the 6.1 release of the software» 4 file access method known as 
DELAYED RANDOM was implemented» Wher DELAYECO RANDGM ts used» the 
first reacuest for a tLogicel record cf a given tlock of a DELAYED 
RANDOP file will result in a physical [/0 which reads the. 
necessary block into memorys Subsecuert accesses to the block 
wiil rot generate any physical [T/0's as Long as the block remains 
in meworys A block is overlayed if a4 request is made for a block 
not currently in wmemcryr at this time the Least recently accessed 
block is chosen as the one to overlay. Tf tre chosen block has 
been updated in memory it is written to disk before the new block 
is regéde Periodically» att blocks that have been updated in 
memory are written to disk by the SMCP. | 3 


SEEK (MICRG MCP) - 


CT.VERG G3 | 

CI.O8JECT  FILE.NUMBER 

CT»ADVERB | 
“Cle1 °  . «= 

CT.2 - a 
£12 RANDOM FILE ACTUAL BINARY DISK KEY 
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The SEEK communicate is an tinstructicn to the MCP to. position the 
arms croperly» on movabte"arm devices» and to fill one of the 
buffers assigned to the file with the kbtlock of data which 
contains the requested tlogicat reccrd. This communicate is 


applicable to random cisk files only. The user is not forced to 


wait for the completion of an £[/0 operation iritiated by a SEEK 
commuricatee He may ke forced tc wait if there is no buffer 
available to use for the operation. | 


The SEEK communicate may he used by tre user programmer to mask 
some or att of the time regquirec by a READ communicate with 
computatione It may also be used» efrior to a WRITE communicates 
to elimirate the necessity of weiting tcr a buffer to be 
prefitled when using biocked files. | 


No data as moved to or from the user's work area by the regis of 
a SEEK communicate. . 


2 GN ee a VE pis Sp pe A sin 


CT»VERE 04 
CT.~CBJECT FILE.NUMBER 
C1.ADVERB BIT 


C4 ? 
=> TRANSFER | 
6 POCKET SELECT 
é STOP-FLOW 
& SATCH“COUNT 
g POCKET LIGHT 
19 = 
11 ENDORSE 
CT.1 POCKET NUMBER | 
CT.2 | BASE RELATIVE TRANSFER ADDRESS 
CT.? | BIT LENGTH OF TRANSFEREEC DATA 


The SORTER CONTROL communicate is usec in conjunction with files 


-assigred to Reader~Sorters only. Such files may he utilized 
- properly in COBOL programs only. Cther Léenguages may include 
porticns of the syntax necessary § =“*for proper use of oa 
Reader-Sorter » though onty COBOL contains everything that its 


necessary. 


When the MCP receives an I/0 Complete interrupt from the 
Reader=Scrter» it immediately references the orogram which 1S 
using that sorters determines the Segcry adcress of the “USE 
ROUTINE work area» and places 4 formatted copy of the result 
descrictor fre the I/0 operation follcwed ty an image of the 
item itself ir the work areas It ther reinstates the user at the 


ccde z~ddress cf his USE ROUTINE. (For acditicral information on 
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Item Frocessirge refer to the BiC00 CCBOL Reference Manual» Form 
Number 1¢€57197.) | | 


The MCP takes the action described ekove regardless cf other 
processing that is occurring. The ection described 1s commonty 


known as "High Priority Interrupt Handling”. 


Only three of the tive possitle advert bits may be set in a 


commuricate addressed to the Y¥CP white the user program is 
executing the LSE ROUTINE. These three tits are TRANSFER» 
STOP“FLOW and POCKET SELECT. The TRANSFER bit 1s discussed 1n a 
subsequent paragraph. Tf the PCCKET SELECT tit is set» the MCP 
will use the value in CT.1 as the pocket number on the sorter tor 
that item. If the STOP“FLOW bit is set tn the adverbs the CP 
wilt also issue the appropriate 1/0 Descriptor to the sorter. 
After receiving the communicate» srecardless of the adverdD bits» 
the MCP will continue doing whatever it was doing at the time the 
interrurt was receiveds the user tust give up controt at thts 
pointe — 


Pocket selection on the sorter thus happens asynchronously with 
everything that is occurring on the system» except the sorter. 


This is currently the only device ccennected te the 81000 which 


operates in such 2@ Manner. The necessity for this action is 
dictated by the fact that the sorter is actually a *real~time” 
device and trust be serviced in a specific time period after a 
check has Leen read by the hardwaree | 


The TRANSFER bit and its function was added te the 8.9 version of 
the MCP. When the TRANSFER bit is rot sets which will be the 
case for att programs compitted pricr to tne 8.0 release of the 
softwares the MCPe upon receiving the POCKET SELECT conmuntcate>s 


will dispatch the cocket number supplied to the sorter control 


and place an image cf the item in a “tank” area In memorye | The 
number af items that may be cortdined in the tank area is 
specified by the user and corresponds te the number of oduffers 


requested for the sorter file. In zectuality» there wilt be only 
one buffer and [7/0 descriptor» regardiess of the number 
requested» kut the buffers requestec will te used to determine 


the size of the tank area. 


Itew images will he removed from the tank wher the user program 


does a SORTER REAL operation on the scrter file»~ The images will 


be delivered in sequence to the progran.e Obviously» the tank 
area witli beccme full if items are irtroduced to the system more 


rapidly than the user program does SCRTER READ operations. T f 
this cccurss the MCP will dispatch @ STOP“FLCW I/0 descriotor to 


the scrter cortrol» thus stooping the intreduction of items. 


Flow -wiil be automaticatly started ty the MCP when the tank area 
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is again empty. In this manners the system prevents | 


TOOLLATE_TO_PCCKET_SELECT end TOO_LLATE_TO_READ conditions from 
occurringe : 


If the TRANSFER pit is set in the SCRHTER CONTROL communicates the 
MCP will not tank the actual image cf the item but will store the 
data at the location snecified by CTe2 and CY¥.3 from the 


program*s run structuree In this mérnere the user may cause the 
MCP tc tank whatever he chooses» thus eliminating the need for 
severzl programming steps from the user programe. A maximum of. 


one hundred characters may be passed ard tankeca per item. 


The BATCH“COUNT bit in the adverb is used to advance the batch 
counter on tte sorter by one» each time it is received ky the 
MCP. This advert bit will only be accepted by the MCP when the 
user program 1s not ir the POCKET SELECT USE ROUTINE» and a High 
Priority Interrupt condition does not exist. 


Fach pgecket or a Reader~Sorter has a red indicator tamp» visible 
to the operators above ite Tre Lights may be turned on 
programaticatly by the object pregras issuing 2 SORTER CONTROL 
commuricate with the POCKET LIGHT Lit in the adverb set. Upon 
receiving such a communicates the MCP will issue an I/0 
descriptor tc the sorter which wifl instruct it it turn on the 
light above the pocket specifted by CT.1. The hardware will onty 
take such action when the flow of items through the sorter has 
been stopped» YVhe same is true cf the BATCH COUNT operation. 


A AE OEM TA rem <TD ete ste ae ee eae ae eet 0) eRe came sem 


CT.VERB 05 

CTe-C8JECT FILE-NUMBER 

CT.ADVERB = 

CT ol READ AREA BIT LENGTH 

CT.»z : READ AREA BASE RELATIVE ae ADDRESS 


Check Citem). images are passec to the user program 
asynchronously. As described above» an iter image is passed to 
the program whenever one is avaitable to the system. The user 
program is expecting to READ these igages Sycinrongu aly howeveres 
by issuing SORTER READ communicates. 


The MCP therefore Bawnunaealy stores these images in memory» 
passirg them to the user program ir succession» upon receiving 
this communicatee (Notice that the tser program has already seen 
the tmages in his POCKET SELECT USE ROUTINE.) This operation 1s 
commcrly knowr as “tanking” 
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The cperation of the SORTER READ caonauricate is simitar to that 
of READ. Item images are passed tc the user's work area by the 
MCP > the lercth and location of the work area is specified by 


CT.l and Ci.2 respectively. 


There is actually a secondary ferpose te the SORTER READ 
commuricate> it informs the MCP fo the user program's processing 
raten As described abover images e~re passed immediately to the 
user for pocket selection but any other comauricate from within a 
POCKET SELECT USE ROUTINE is orohibited~ The tmages may not be 
written to disk or saved hy the user ir any manners» except when 
they gre received via a SORTER REAC cofmunicate. 


Therefore» if the scft “tanks” cf item images maintained by the 
MCP tegin to fidtl up» which indicates that the sorter is. 
delivering images faster than the user can process thems the MCP 
will gutowatically stcp flow on the scrter urtil the user programs 
catches up. The sorter may therefcre operate sporadicatly» in 


bursts» tut ali items will at least te pocket selected. 


The image of the item in the tank is preceded by a twenty four 
digit (€ninety~six bit) expanston cf the actuat result descriptor 


received from the hardware in connecticn witn that item. This is 


passed to the user program on the SCRTER REAL communicates - just 
S it is placed ir his USE ROUTINE werk area prior to reinstating 
nis USE ROUTINE. © | a 7 : 


Though only two communicate formats are implemented for use with 


Reader~Sorterss» the MCP must do a tot more to make this operation 


possible. A program which opens a scrter causes many different 
items to te merked nonwoverlayable ir memory. This is described 
more fuliy under the CPEN communicate. For a more comprehensive. 


explaration of Reader~Sorter operaticrs refer to the 861000 COBOL 
Reference Manual» Forr Number LOS7TIS7 6. | 


len 

ics 

es 
Nad 


OREN 


ct. VERB 


CTeOBJECT INVOKE NUMBER & PATH NUMBER 
CIADVERB = BTT | 


>) 
>) 


INCLUDES PACKID CF DICTIONARY 


pad &S 


DM.STATUS FORMAT 
O=BINARY | 
1=4-81T DECIMAL 
ON EXCEPTION 
UPDATE. a 
«REORGANIZATION C REORG ONLY) 
“11 - | 


ia) 


mH UT & te 
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CT.1 DMA STATUS REGISTER BIT LENGTH 
CT.2 CMeSTATUS REGISTER BASE RELATIVE BIT ADDRESS 
-CT.3 DATA BASE NAME SASE RELATIVE 817 ADDRESS 
CT.4 CATA BASE NAME BIT LENGTH 
CT.5 PACKID BASE RELATIVE FIT ADCRESS C31T G OF 
| CTe-ADVERB = 1) 
CT.6  PACKIO BIT LENGTH CAIT 0 OF CT.~AQDVERL = ay 


CLOSE COM) 


CT.VERB C7 
CT-CBJECT = 
CTeADVERB EIT 


c“i = | 
2 DMeSTATUS FORMAT 
Q=BINARY — 
1=4-BIT DECIMAL 
3 ON EXCEPTION 
4-110 = 
CT.1 DM.STATUS REGISTER BIT LENGTH 
CT.2 DM.STATUS REGISTER BASE RELATIVE BIT ADDRESS. 
QPEN 
CT.VERE = OB 


CT.-CBJECT FILE.~NUMBER 
CT.2ADVERB ETT |. : 
| INPUT 


0 
1 OUTPUT 
2 NEW FILE 
3 PUNCH 
4 PRINT | | 
S NO REWINO/INTERPRET CDATA RECORDERS) 
6 REVERSE/POCKET CCARD PUNCH) 
7 LccK 
8 LOCKOUT 
9 REPORT FILE MISSING 
1c REPORT FILE LOCKED 
11 OVERRIDE NAMING CONVENTION AND SECURITY. 
-beinstate. MSGePTR VALUES 
sg GCCD OPEN 
1 FILE NOT PRESENT CINPUT DISK) 
PACK NOT PRESENT COUTPUT CISK) | 
NO MORE FILES ON MULTI-FILE REEL CTAPE) 


2 FILE LOCKED COISK FILES ONLY) 


The CPEN communicate serves erimzrily to aS SC Pats a ethysical 
file with the logical file dectared in the user's program. The 
commuricate has other functions erc is alsc used when such an 


association has already been made. Basically» the processing 
invoked by an OPEN communicate oheys the rules set forth in the 
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defiriticn of the CNBOL lenguage. 


The object program must pass the unicue file number assigned to 
the file by the compiler in CITAQ8JECT. The MCP will use this 
number to obtain the disk address of the FPB constructed by the 
compiler for that file. It wiilt read the FPB into memory» 
allocéete memory to cortain the FIE» the proper number of I/0 
descriptors and the buffer areas fcr the file. Tt will then 
construct the FIB» thased unon the irfcrmaticr in the FPP.» the 
physical characteristics of tne device assigred to the file and» 
in some cases» the logical characteristics of an existing file. 


The memory area allocatec for a file is» exceft in the case of a 
Data Management filer» a contiguous area» OQne memory link onty is 
necessary to cescrite a file area. The file area wilt contain 
ali cf the items mentioned in the preceding péragrapth. FIBs vary 


 9n size» deperding on the type of device assicned. No memory is 
allocéeted for this purpose urtil 2 device assignment has been 


Made « 


Gre cf the first tests made in the OPEN routire is» “Is the file 


alreacy Cpen?". This is a viatation of the rules of alti 


languages and the MCP has no choices if the test is trues but toa 
discortinue the program. There céerrot be two consecutive. OPEN 


commuricates on the same file without an =tntervening CLOSE 


commuricate. 


Another pretiminary test is » "Has a device assignment already 


been nade?" Tf true» the OPEN orccessing fellows a different 
COUrS€ » Device assignment is af frime importance to the OPEN 
routire. 7 | | 

Device Assign ent (Excent Disk) 


A third preliminary test is whether cr not the file is to be 


assigred to diske If the file ts a disk file» the course of 
actior followed is described under the heading “Disk File 
Assigqrment™. The remainder of the discussion under Device 


Assignment applies to non=disk files» that are being Opened’ for 


the first time. 


The rext major test made by the CPEAN routine is whether the file 
is being cpened for input» output cor toth. Cnty certain card 
devices» such as Data Recorders» tay be opened for both input and 
output» exclusive of disk files. Certain cther combinations of 


the various tits in the adverb are zlso illegal. These wiil be 
discussed in turne For the case mertioned above» attempting to 
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open a card reader» for example» for output purposes will result 


an the program being DS~ed hy the MCP. 


If the file is being opened inputs» the MCP will attempt to match 
the external rames in the FP8 of the file» FPBs.MULTI.FILE.IU and 
FPBe»FILE.ID» with the Labels read freviousty by the STATUS 
routire on each peripheral device. If no watch is founds the 
operator is notified and the progra# is forced to wait until a. 
tile with the requested tabel is introduced to the system» or 
until the operator resolves the "No File™ condition is some other 
manner. System SPO ard Control Card syntax is available to allow. 
the cperator this alternative. The program wiil removed § froa 
memory if possible. | | : ar 


[f a match is  fourd = on two or more units» the operator 1s 
notified-cf this alsa and aqaine the program is forced to wait. 
The PCP cannot reccver automaticatly from this condition> the 


operator must inform it that he has resolved the "Duplicate File” 


Situatione | $Again»s system SPQ are Controt Card syntax is 
available to do thise | , | 


The MCP%s Control Card routine is invoked wherever a card input 
device gces from a Not Ready conditicr to a Ready conditicne The 
reutire then reads the first card frem the devicee If this cards 
or in some cases» a subsequent card causes a job to be scheduled 
for execution» the Control Card routine retains control of the 
MCP» reads the next cards» and processes ite It wild continue toa 
retain controt untit the card reader coes not ready» or until a 
DATA card is enccuntered.j If the Control Card routine terminates 
processing due to the encountering of a DATA card» the physical 
input file described by the DATA carc is associated with the tast. 
job which it placed ir the schedule. This ts only true if the 
Contrcl Card routine did not Lose control between the time it 
encountered the card which caused a ject to he scheduled and the 


time it encountered the UDATA card. 


The wCP wilh not report 2 Duplicate File Situations if one 


exists» if tre input file being operec is ¢@ card file or a 
pseudo~reader file and if the job has a physical file associated 


with it in the marner described above. Rather» the MCP merely 


allows the associated physical file to be apened by the job» 
proviced the external identifiers in the physical tabel and in 
the FPB are ecual. —_ 


Contret Card syntax is provided to allow the operator to specify 


the physical untt which contains 4 specific icgical file. This 
specification may be made when the jcb is scheduled for execution 
or it may be made permanently ty moadifying the FPB tn the 
program's code file on diske- If such 4a specification has been 
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made» the MCP *s OPEN routine will nct attempt to match external 
identifiers» but wilt simply assign the physical file on the 
requested unit to the logical file teing opened» orovideds» of 
courses that the unit is available fcr such an assignment. It 


should be noted that making such a specificaticn in an FPB also 
changes the hardware type in the FPB to match the hardware type 
of the unit specified-e Units are specified by mnemonic name. 


If the untt being opened is a tape urit» additional tests are 


necessary before the device may ke assigned. The Reel Number 


 fielc in the unit's Label must match the corresponding field in. 


the togicst tile'’s FPB. For tape uritse MultitFile [denttfiers» 
File Identifiers and Reel Numbers must alt be equal. Also». in 
the céese cf a tape file» Control Care syntax is provided to allow 
the cperator to specify the Sertal Number of a particular reet of 
tape. If this is doree alt four ccrcitions must. be mete As in 
the case of unit mnemonic  specitications Serial Number 
specification way be made when the jct is scheduled for execution 


or it may be wade perwanently. 


The MCP will allow tape files to be opened when the user 
progremmer does not know the lLogicat record and physical block 


Sizes actually written on the tape. These fields are teft 
unspecified ir the FPEB by the comriler but the default bit in the 
FPBs FPB.DEFALLT» ais turned one The recording mode of a tape 


file may alse be Left unspecified if the bit is set. The MCP 
will insert the prover values into ttese fields when the tape is 


opened» proviced the inforsation is present in the tape's tabel. _ 
If the information is not presents $ the frogram wilt re. 


disccortinued when the OPEN is attemptec. 


The VCP witl also insert values for record end block sizes when 
ali card input files are opened ard FPEeDEFAULT is set. 


The MCP will discontinue any program which attempts to open a 
file contained on seventtrack tare if the Logical record size 


- contained. in the FPB for the file is not modulo six and if the 
programmer has specified = the tape to be read without hardware 


transtation to EBCDIC. This is true regardless of which bit» 


Input or Cutput» is set in the Adverk. 


When the MCP receives a request to OPEN a file for output 
purpcesese one of the first items that must be checked 1s whether 
er mot the file should be assigned te 4 Backur devices which may. 


be tafe or diske If the user has recuested that the fite be 
directed to backup» this witt cccur beftcre the search for a 


suitakle output unit is made. Sacker capabilities are discussed 
ina separate part of this document. - 5 
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Assuming that the file is not to be sent to Backup» the MCP next 


checks tc see if the user programmer has requested that the file 


have special forms for output. This test tis made for all output 


files» regardless of device type. If FPBeFORMS is set to one» 
which indicates that special fora@as are required» the MCP will 
print an appropriate message and force the program to wait until 
the crerator replies in the proper werners Syntax is provided to 


allow this. Wkhen the operator reoliess the OPEN routine is again 


invoked and the file will he assigned to the device specified by 
the oferators» is any» provided the urit available. 


In the absence of a Forus specification by the users the MCP will 
search the IJOQAT for an avaitable crit of the type specified by 


FPBe-HDWR.» As described in a prior section» certain values which 


this field may contain are mot actually hardware types but 
specify a group of types» such as “ary tape™»s “any head~per~track 
disk™ and so forthe In order tc he. avaitable for output 
purpcsess the unit must te ready» must not be currently in use by 


another program and must be write enabled. 


at the MCP cannot find en available unit of the type. panwecced: 
it will check to see if it is permissibte to direct the output to 


a Backup device. If so» it will attempt to de soe This is also. 
discussed in the section of this. specification describing the 


Backup operatione 


If there is no available unit of the type specified by the user 


and if it is not permissible to direct the file to a Backup 


device» the MCP will print a message on the SPO to inform the 
operator that such a unit is requirec before the programs which 
will te identifieds can orcceed. The program will be forced toa 


watt at this points and wiil be removed from memory» if possibie. 


The wep may recover the progras fron this condition. 


automatically» with no operator intervention. If a suitable unit 
DecomES available for output purposes» the OPEN communicate 


‘processing for the program will be repeated. Control Card and 


Keyboard syntax is provided to attow the operator to override. the 
hardware type specified in the user's FPB&. Syntax ts also 


- provided to allow the operator te force the OPEN processing to be 
repeated. In or case» the MCP merely tries agaiis | 


‘The MCP will automatically discortinte any crogram which attempts 


to OPEN» for output ourposess a file whose hardware type 


specifies a paper tape readers» a regcer sorters: a cere: Reader 3a 
eyerer SPO or an unknown device. | 


free 
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Certain devices an the SiICOC may te cpened for both input and 
Output operations. These deviees are ait: card devices? no tape 
unit way te orened for eth types of cperaticrse except via the 
Emulator Tase constructs. At the fresert timer tnere are anty 
three such devices» and they have ccne to he commonly krown a5 


"Data Recorders”. Actually acccrding tc the £10900 Systems 
indexes P.eS.- 1904 5S641>» they are the: : | 


Le E9418-2 &0-Column Keypunch*Prirter 
 2e BI419"-2 FVE-ColUunNnN Keypunch"Printer 
Se 89419-6 96-Caolumn Keypunch~Printer-Sorter 


ALL of the devices in the ahove tist have one “Wait Station”. A 
Wait Station is usec for holding tte ohysical card after it has 
been read» or at least fed from the input hoppere and before it 
7S printed or punched or bothe All cf the devices listed have at 
Least one hardware huffer» capable cf hoeldirg the. information 
contained on one card. This buffer is used on input operations 
only» “Input” as used here will meer input to the computer. 


fne teble belcw presert the number at input. horoers. ard Outtut 
Stackers on each physical device. | | | 


Cevice Hoppers 7 Stackers 
| Cinput) Ls COutpout) 
9416-2 2. 2 
BG419~2 2 is 8 
B9419-6 2 5 


Three different I/0U Controls sre usec to interface the devices to 
the 81000 system. They are: 3 


le MFC~1 (P.S. 2208 3034) 
Be MFC“2 (P.S- 2208 3024) 
S$. CRPC CP.S. 2211 1371) 


The fcllowing 1/0 operations are cefined in the appropriate 


product specification for all of the controts. 


READ - (From the buffer in the peripteral). This operation its 
knowns fer conversational purposes» as the REPEAT.READ. Valid 


variarts ares 


Stacker Select 
Irhibit Feed 
kepper Select 
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STACKERSSELECT.AND-READ  - (Read the information from the next 


card in the hopper). Valid variants are: 
Stacker Select | 
Inhitit Feed 
Fopper Select 


PUNCH. Valid variants are: 
S$tacker ‘Select 
Inhtbtit Feed 

Hopper Select 


PRINT. Valid variants are: 
Stacker Select 
Irhibit Feed 
Hepper Select 


-PUNCH@PRINT. Valid variants are: 


StecKxer Setect 
Urecqual Data 
Irhicit Feed 
Kepper Select 


PUNCK@*PRINTAZANT.READ Valid vartarts <ére: 
Stacker Select 
Unequal Data 
Heppner Select 


The Stacker ‘Setect variant is actually a three-bit field in the 
I/O Cescriptor. wher the three fits ere set to numeric vatues 
otner tnan zero and sevens the cevice routes the card to the 
stacker selected by the descriptor. Valid numeric values for the 
devices range from cne to Sixe Tre MCP dees not» and cannot»e 
edit the numeric value passed by the cbhject program to ascertain 
that it is valid for the connected device. 


The Unequal Cata variant is valid cnly in I/0 descriptors which 
cause a Punch"Frint operation to te cerformede- [If the variant is 


not set» the device wilt print the sare information that is 
punched on the card. In other words» the beginning memory 


address for the tnformation tc te printed is the same as the 
beginring memcry address for the infcrmation to be punched. If 
the variant is set» the informatior to he printed will be taken 


from @ memory location which imnediately follcns the information 


that is punched. 


The Irhibit Feed variant causes the hait Station in the device to 
be empty at the completion of the operation. No cards will he 
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fed from the Input hoppers 1f this variant 1s set in the 
descriptore 7 


Ihe Hepper Select variant causes the feed card to be taken from 
the secondary input hopnere if there 1s onee If the Inhibit Feed 
variart as set» the Hopper Select variant is ignored. 


There is a Liwitation»s which was mertioned briefly in a= prior 
paragraphe The MCP cannot distinguish hetween tne 389419-2»5 which 
has two outout stackerss and the 89419-6- which has sixe The MCP 
does not edit stacker numbers tefcre itt sends them to the 
contrcl. Therefore» programs which utalize all stx stackers on 
the E94i9-6 may not be transported tc systems which do not have 
such é€¢ devicee Even if tha MCP coulc cistinguish between the two 
devicese the editirg would have to be microtcoded and would 
sericusly degrede performance. _ 7 7 


The capabilities available to the object ovrogrammer |. are 
programmatically selected by variants cn the OPEN communicate and 
by variants on the READ and wKRITE coatunicates. The discussion 


is categorized according to the different types of OPEN 
availzble. | | 7 


when the ¥CP recetves an OPEN request with none of the bits in 


the ACVERS area sete it will assume that the program only wants 


the irformation contained on the carcs and dees not intend ta do 
Stacker selections keadPunch operations» or any other variation. 
available in the hardware. The I/0 descriptors constructed as a 
result of this type of OPEN wilt alt be of the Repeat-Read type. 
There may be any number of tuffers asscciated with the file. Atl 
of the buffers witl ke tilled when the tile is opened. Stacker 
Selection is rot allowed when the file is opered in this mannere 


when the MCP receives an OPEN request with the Pocket bit set» it 
will construct one descriptors» the cperator field of which will 
cantain @ STACKER.SELECT~AND»READ instructions The buffer witlk 
not. be fitted when the file is onenred. The first READ on the 
file will cause the first card in the data deck to he moved past 
the read head and stoppec in tne hajit Station. The data from the. 


card wilt be transferred to the object program's work area hefore 


contrct is returred to the program. Stacker Select information. 
passec on the first read may or may not be passed on to the 
deyice and will have ro effect at all. 7 | 


The second anc all subsequent reads sheuld have Stacker Selection 
information assoctated with them. The MCP will note however» 
incluce code to insure thise The WCP witt not allow more than 


one buffer to be associated with this type of ‘file. 


DRSBOD ELLE P2900 BN oe ba EB TT 
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This action is distinctly different frem the roast common tyne oft 
REAC request handled Ly the MCP. Tee actual oderation is always 
issuec after the communicate is receiveds and never befores as it 
7s with almost all types of innut files. Tre 1/0 operation can 
never be comleted ahead of tne demarc for ite This operation is» 
howevere Similar to the current PCF action for Sequential I/0 
files on Disk. The file can actuettly be thought of as an 
Input/Output file>» for atl opracticat purposese. Tt must be 


considered such a file dy the MCP» tr order for the I/0 to he 


initiated at the proper time in a card read cyclee The QUTPUT 
bit in the OPEN adverb should never be set when the OPEN 15 
requested» howevere This witt cause the cormunicate to have an 


OCLC different meaning. 


Quite chviouslty» due to the differences. in timing» it 1s 
mandatory that the object proqram clcse and re~ooen the file in 
order to chance from pure ENPUT to INPUT WITH STACKER S» and 


conversely. 


A number of variations are possible when the device is avense as 


an output file. There variations are: 


le PUNCH 


Ze PRINT 
3Se INTERPRET 


The Pecket variant may be apclied te any of the first four 
variations» or it may be the only adverb associated with the OPEN 
Statement. Tre MCP» upon receivirg an OPEN communtcate without 


PUNCH» PRINT or INTERPRET regquestec» wilt assume that Punch is 


desireéde Therefore» OPEN OUTPUT ts equivalent to OPEN QUTPUT 
wITH PUNCH erd OPEN OUTPUT WITK. STACKERS is equivalent to OPEN 


‘OUTPUT WITH PUNCH» STACKERS. 


OPEN CLUIPUT WITH PRINT means that the program does not want to 
punch anything into the cards. It only wants to print 
information. | | | 


OPEN CUTPUT WITH PUNCRs PRINT means that the program wants to. 
punch information into the cards and wants to print different 


-inforgation or theme The MCP will aliccate the number of buffers. 
requested by the programs aach huffer wilt be 192 bytes Longe 
The WCP will) exnect te receive 192 tytes of information cn each 


WRITE communicates 96 of which witl te punched in the card and 96 
a which will ue printed. As always» it 1s not mandatory that 
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the program detiver the fult 192 by teSe “The move from the work 


area to the buffer is left-justified with tlark fill. 


QPEN CUTPUT WITH INTERPRET neans that the prooram wants to punch 
96 cytes of information into the cércs and print the sare data. 
The MCP will atlocate the number af tctuffters requesteds which 
must ke at least two» each wilt be S€ bytes in Length. The [7/0 
descriptor corstructec will snectfy ¢ PUNCH-PRINT operations and 
the UNEQLAL DATA bit will be set to zeroe. The INTERPRET request 
will have precederce over PUNCH» PRINT and a combination of the 
twOe OPEN OUTPUT WITK PUNCHe PRINT» INTERPRET should probably be 
rejected as a syntax error by the conanilerse The MCP will accept 
the communicate» howevers and assume that the programmer meant 
only INTERPRET. The same applies tc OPEN CUTPUT WITH PUNCH» 
[NTERFRET and CPEN OLTPUT WITH PRINT» INTERPRET. | 


The FOCKET variant may be scaecifiec cn any valid request for an 
OPEN CUTPUT. The variant 1s ignorec ty the MCP on the OPEN 
requeste This 15 not true for OPEN INPUT WITR STACKERS»j) It must 
be true for GPEN OUTPUT» however»s te avoid cronplems which may 
arise when the device assigned ta the file is changed by a FILE 
card cr an “OU" message. The WRITE ccmmunicate contains a bit 
which requests stacker selection. The MCP examines this bit and 
takes approoriate action on each WRITE communicate. 


ALL of the variations possible when a file is opened OUTPUT are 
also possitle when the file is cpered INPUT.~QUTPUT When the MCP 
receives an OPEN INPUT~OUTPUT request with none of the variants 
sets it assumes that the user wants tc read the information from 
the cards» and purch aoditional infecrmation into theft» and print 
the same information on them. Therefores. CPEN INPUT»~OUTPUT is 


ecuivelert to OPEN INPUT.QUTPUT WITH INTERPRET. 


The adverbs PUNCH and PPINT are relatively useless when the file 
as erened INPUT.OUTPUT. Both purching and printing occur when 
the PUNCE-PRINT.AND-READ T/0 cperetcr is dispatched to the 
contrcl. There is no way the déevice can te made to print and 
read cr punch and read only-e These cpeations can he simulated» 
of courses by setting the UNEQUAL.DATA bit in the descriptor and 
loadirg the preper portion cof the tuffer with blanks. This 
requires some action cn the part cf the programmer. _ 


The LNEGUAL.CATA Frit is set ir the I/0 descriptor when the MCP 
receives an OPEN communicéete with both the PUNCH and PRINT bits 
set ir the adverb. As in the case cf OPEN GUTPUT» the INTERPRET 
bit hes precedence over both PUNCK gerd PRINT. OPEN INPUT.OUTPUT. 
WITH FUNCHs PRINT» INTERPRET snould be considered a syntax error 
by the compilers. When the CF receives such a request» 
howevers it generates a PUNCE-PRINT.AND.REAG I/0 descriptor with 


sia aia 
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the UNEQLAL-DATA variant reset. 


Files opened with various attritutes require or can onty us 
vartous number of buffers. 


ve) 


Attributes — Requires Can Use 


Input onty» not Stackers 


1 Infinite 

Input onty with Stackers. t 1 | 

Qutput onty 2 infinite 
Gutput and Incut 3 


3 


if the number of buffers specified fer a file is less than the 


number requireds it will be allocatec the number required. Uf 
the number specified is more thar the number that can be 
effectively used» it wilt be allocated only the number it can 
uSC «= 


As in the case of OPEN INPUT WITH STACKERS» the MCP will not fill 
the tuffers when the file is onered.j« The first READ issued for 
the ftle will cause a card to be fec» read arc stopped tn the 
wait station. The information frcem the carc will be passed to 
the ctject orcaqram at that point. It may be necessary fer the 
MCP to treat the first READ on suct a file differently from alt 
other readse This shculd be of no ccrcern to either the. compiler 


or the object programfer. 


After the first REAP on the files the MCP will normally expect to 
receive two communicates for each céerc passed through the device. 
There shold be one WRITE request and one READ request for each 


physical card. The errogram should cass 96 bytes» or 192 byteses 


of information to the MCP on each WRITE request. The information 
will te moved from the program's work area to the buffer on the 
WRITE communicate. The actual I[/0 operation will be initiated at 
this time and the program witt be allowed to continue» Without 


Waiting for Rl completion of the operation. | 


the cP will normally expect to receive a READ communicate at 


this ccint» ard the crogram may te forced to wait for the 


cagnleticn of the I/0 oneraticn issued freviousty. After 
completions the information read frem the card ere be passed on. 
the READ communicates as always. 


it is not mandatory that the spocess Bigs fellas the READ/WRITE. 


sequerce described in the foregoirc. If the program issues two 


successive WRITE requests» the input information on one of the 
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cards involvec will be lost to the program. The consequences if 


a prceogram issues two successive REAC requests are somewhat more 

Giree. the information punched and crirted on the first card will 
also be punched and printed on the second. Though this sounds 
rather bade this could possibly be cf some use to someone. 


Since the actual I/0 operation for this type of OPEN is initiated 
on the WRITE communicates any stacker selection infornation must 
be passed alonc with the WRITE commuricate. Stacker infcrmation 
passed on the READ witl be ignored. 


The MCP will ibewsteoally discontirue programs that attempt to 
OPEN a file on any of these devices if: 


1. Neither the Input bit nor the Uutput bit is on in the 
Adverh» — 7 


2e Goeth the Print and tne Intercret bits are on in the adverb» 
OT. | 


3. The program is attempting te use a 967™coluMmN device in the 
eas recording mode. 


Disk File QPEA 


: | When 6s user program attempts to OPEN & file which is assignea to 
ig Gdisk» the first test made in the Oper Routine is whether the file 
| is a rew file which the program is creating fcr the first time or 
an oatd file which already exists in the disk directory. In the 
tirst case» a disk file header wiil eventually be constructed in 
memory icy the OPEN routine. In the second case» the disk file 
header already exists and is stored ir the directory and wilt 
have to be brought into memory ty the Routine. The Open 
procecure for a new file will be discussed first. _ 


‘ wd 


Programs which attempt to open new files for input and output in 
the serial access mode will be autoretically discontinued at this 
point. Also» programs which attempt to over a new Multi~mPack 
File and have tlanks itn the PACK.ID field or the FPB wiil he 
; | automaticaliy ciscont tinued. | : | 


If the Open communicate specifies thet the file is a code files. 
the proper rames for the file witht te stored in the FPB at this 
point. Also» the number of disk areas requested in the FPS will 

be autematically set to one. The fact that this is a code file 

will Ee recorded by the MCP in the FPB for the file» This 

information is required when the file is closed. 


ons 
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If the PACK.IfD field of the FPB ccntains something other than 
EBCOiC bianks» the program is recuesting that the file he 
directed to a user pack with that IDe The MCP wills at this 
pcints examire the Pack Information Table maintained tin memory 
for a pack with the corresponding idertifier. If such a pack 15 
presert an the systems the routine continues. OQtherwise» if the 
user has requested that he be rotified when the pack is not 
present oy setting the REPURT FILE MISSING bit in the adverbs he 
will te so notified at this point are control wilt be returned to 
the user through the normal processor queue mechanisms. 


If the REPORT FILE MISSING hit ts not set» a message to the 
operator witt be cisplayed and the program with be suspended 
until the requested pack is introducec to the system or the 
operacr overrides the PACK.~ID specified. Control syntax 15 
provided to atlow the operator several means of accompttshing 
thise 


{f the file being opened is a multipack file and 1f the serial 
numoer of the chysical pack is zerc cr if the pack is already a 
contiruation pack for another multipéeck filer the program wilt be 
automaticaltiy discontinued.j [If the rumber of areas requested for 
the file ty the programmer is creater than 1055 it will be 
auto@aticaliy set to 105 by the MCP. In the latter case» no 
wearnirg is sent to the operator. ms : | 


Memory for the file neader is allocated at this point. Tf the 
user had reguested that the disk areas to be assiqned to the file 
pe allocated when the file is onenece the attocation is done at 
this foints provided sufficient disk is available. If sufficient 
disk is not avaitable- the prcaram is suspended and an 
appropriate message is disptayead on the SPO. | | 


The File Header is now constructed ir wmemcry» based upon 
information contained in the FPB. The ultimate dispensation of 
the hedder is dependent upon the tyne of CLOSE communicate 
performed on the file. | | oo 7 


At this point in the OPEN processing» the togic becomes the same 


for new ard olc files. Before proceeding with a description of 
the icgic at this point» it wilt be acvantageous to describe the 
processing which occurs when the user opers ar existing file. — 


when the user requests an Open of ar existing files the first 
occurrence is a determination of whether or not the file is 
presert on the systefe ALL three réewes in the FPSB must match an 
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existing file if the rame fields contain something other than 
EBCDIC blanks. | 


If the PACK.IC Field is clanks the file is assumed to reside on 
syste® diske The directory on the system disk will be searched. 
If the PACK.IC field is not blanks» it specifies that the file 
exists an a removable user pack of that name. If there is no 
such fack on the system at that times the program is suspended» 
with an appropriate onerator messager until’ the pack is 
mtrcoccquced te the system or the cperétor overrides the PACK.ID in 
the FPR. There are several neans provided for the onerator to 
acconglish thise If the REPORT.FILE-MISSING bit is set in the 
commuricate adverbs the program is not suspended» but control is 
returred to it through the norgat erccessor queues and the fact 
that the pack is not present is renerted to it. In either case» 
the CPEN cannot proceed past this poirt. 


After the decision abovee the MCP next searches the directory on 
system disk or on a user pack for a file identified by the names 
in FPE.MFIS ard FPB.ZIL. If the file its not founds the action is 
identical to that described above. If the file is founds further 


decisions are necessarye 


If the LOCK bit is set in the OPEN acverbe there may be no other 
users who are writing to the file. There may be other users of 
the files but none of them may be usirg the file for output. §£ If 
the LCCKCLUT bit tis set tn the OPEN acverd» there may be no other 
users of the file? the user who is presently opening the file 
must be the sole user. If these conditions are not met» an 
operator messace 1s disolayed and» cerpending upon the setting of 
the REPORT FILE ‘LOCKED bit in the adverb» the user is either 
susperding or notified of the conditicne ~  e 


‘Assuming that all cf the conciticns. specified are met 


satisfactorily» the File Header is brought into memory by the 


MCPs if it is not there already» ard the user count field in the 


header is incremented. If the CUTFUT bit ir the adverb is set» 


the cutput user count field is also ircrementede 


At this point in the OPEN processing» ait of the paths converge. 
If the file is not a disk file» a device has been assigned to it. 
If the file is a disk file» the File header is in memory and its 
associated disk areaS» if any» are essentially "assigned" to the 


file. The Fite Information Block CFI8) must row be constructed. 


Construction cf the FIB is a rather wechanical processe— After 
inityelizing certain fields in the I/0 Assicqrment Table CIGAT). 


memory to contain the FIB is altlacatecs if this has not already 
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occurred. As mentioned in a pricr sections the amount of memory 


allocated for an FId is dependent upon the type of device 
assigred. , : | 


the FIB itself is constructed from information contained in the 
FP8s» from infcrmation in the Disk Fite Headers and from the 
parameters passed in the OPEN comatricate. After this occurs» 
the [7/0 descriptors are constructed» Memory space which contains 
the 1/0 descriptors and their assceciated buffers is allocated 
with the FI8» such that the FIB cartains rot onty the file 
information fut alsc the descrirtcrs and buffer areas. The 
memory necessary 1s then a contiguous block. This statement does 
not apply to Cata Management System tuffers» which are allocated 
separetelye | | 


For serial» input only files» each I/C descriptor is initiated as. 
it 3s constructed. The buffers ere hence “pre~fitled” by the 
operating system when the file is openedsj This is true of all 
files except those assigned to a reacersorter and those assigned. 
to a cata reccrder where the user fas specified that stacker 


selection is to be performed on the ceérdse 


For output files which are not éessigned to disk» tlabets are 


constructed and written according te the user's specificationse 


Tape tabels are discussed in the ncrtion of this document which 
describes Magnetic Tape Management. For input files» the device 
assigned will be positioned such that the first READ issued by 
the program yeitds the first ohysical record from the device. 
This ts often accomplished by the Oper routinee 


If tte user has requested that trerslation be performed by the 
softwares memory to contain the Trarstation Table specified by 
the user is atlocated by the Open routine» The Translation Table 
1s aiso brought into memory by the Cren routire and pointers toa 


at are constructed in the FIB. Tf the specified Transtation 


Table is rot cresent on disk at the time of the Open» the pragram 


3s suspended and an appropriate operator message is displayed. 


If the LOG System Option is set» entries are wade in the log when 
the file is opened» The FPB for the file is also the tog entry | 
and certain fields therin are ufdated and modified. At the | 
coenclusicn of the Open processingr ccntrol is returned to the 
user if OPEN was invoked by a coamunicate. In alt languages 
excect COBOL» OPEN may be invoked ty a REAC» WRITE or SEEK 

commuricate. If this was the casere controt is returned to the 

appropriate communicate handler via the systems processor queuese — 
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CLOSE 


—CTACCRBJECT FILE. NUMBER 
CT ADVERB BIT | 
| REEL 

RELEASE 

PURGE 

REMOVE 

CRUNCH 

NO REWIND 

OVERRIDE NAME CONVENTION AND SECURITY 
LCCK 

IF NOT CLOSED 

ROLLOUT 
AUDTT SWITCH 

TERMINATE 


mee OTM WOE US Ww A mee 


ht 


Tne CLOSE eodainicate allows the user to specify the dispensation 


of files that he has created. Should a program terminate withcut 


performing a Close cn any file that he has opened» the MCP will 
assume that the device assigned to the fite is to be returned to 
the systep’s resources and that the cata contained in the file 
Shoulc not be retained. | 


A second purpose of the Close rcutine is to bring the I/0 


activity on a device» which haopens scmewhat asynchronously with 
a procrag's processings to an orderly halte I[t also returns any 
memory assigned to the file to the systeme Clearly» an I/0. 
aqescriptor and buffer area cannot be returned to availabte memory 
until the I/O operation it descrites is complete». In order toa 
accoaclish this» it 15 Often necesséry for the Close routine to 


give up control of the orocessor and regain it when certain I[/0 


operations go to completian.e 


The first test performed by the Clese routine iS whether or not 


the fite has ever teen opened. A CLOSE commurtcate issued = for. 


such a file ts considered a programming error and the prograa 


witl be discontinued at this point. This is done primarily to 


infor the object programmer of the tect: that. there as something 


is wrong. 


The second test performed by the Clcse routine is whether or not. 
the file is open nowe It is consicered a programming error if a 
user requests a Close on 2 file thet is atready closed» as 


opposed to never having been openeds if the IF NOT CLOSED bit is 
not set in the CLOSE communicate adverb. The program wilt he 
automatically discontinued if this errcecr is detected. If the [IF 


NOT CLOSED bit is set in the adverb and the file is already 


closed» controt is returned to the user program through the 
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nornal processor queue mechanism. Alt other bits in the adverb 


will Fave no effect ard the fil? is rot closed a second time. 


Betore proceeding with a descriction of the mechanics cf the 
CLOSt communicates it will he hereficiatl to explain the function 
of the various bits in the adverb. The REEL Eit is used on files 
which are assicned to magnetic tape crtly.~- It. is ignored by the 
ccde if the file is assigned to any cther device. It causes the 
MCP cc close the reel ot mNagqnatic tare that is currently being 
processeue The ttle wtll be clesec and the reet will oe lockted 
by the MCP. If the user program issues another OPEN communicate 
for the file» the next reel of the file». in numerical sequences 


will te sought hy the Ooen routine. 


It ts not necessary for the user prcgram to issue CLOSE REEL 
commuricates when the physical erc cf the reel is encountered. 
This is done automatically by the MCP. Reel-to-reet transition 
is accomplished without the involvement of the user program. 


The RELEASE bit in the adverb means that the resources assignea 
to the file are to he returned to the system. New disk files 
which are clesed with RELEASE witl have their assigned disx 
areas» if any» returned to the List cf available disk. Permarent 
disk files which are. closed with FELEASE will have their user 
count fields decremented tut will renain in the disk directory. 


Devices cther than disk wilt be marked available for use by other 


jots» provided their rhysical status cermits. 


Tne PLRGE function is anplicabte to fides assigned to disk or 


tape only. Tt as igrored if the file is assigned to other 
devices» if a CLOSE PURGE ts operfcrmed on a file which is 
assigred to a tape unit» the tape reel wiil be rewound and 
purgece provided itt is writeercbled. if it is prot 


write"enabLled» CLOSE PURGE wilt be equivalert to CLOSE RELEASE. 


For a permanent disk file which is clesed with PURGE» the file is 


removed from the directory» pravicec the user who is doing the 


CLOSE is the sole user of the file» and the disk space assigned 


te the file will be returred to the evailable table. A new disk 
file» often known as a “*temporary”™ file» wilt not yet be entered 


in the disk directory» but the disk space assigned to it wilt be 


returred to the available table atsa. In the case of a temporary 
file» tnere can be only one user and it is not necessary to check 


user ccunts before purging. 


The LOCCK bit tin the adverb is intended to be used on files which 
are assigned to disk and tane only. It is itgrcred if the file is 
assicned to other devices. Ynen a file assigned to tane is 


closec with LCCK» the tape reel is rewound and the unit's status 
is marked as “Locked™ in the I0Aq. The unit wittl not be 
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-availeble for use ty other jobs urtil the cperator intervenesr — 


either by making the unit not reacy are then waking it ready or 
by ertering a “Ready” message on the SPO. The intended purpose 
cof this functicn is to prevent the MCP from assigning the unit to 
otner jots before the operator has had a chance to remove any 
tape files which may have heen createc con the unit. 


The LCCK bit» when set on a CLOSE directed ta a file which is 


assigred to disk» causes the fite to he entered in the disk 
directory if it ts a temporary file» subject to the restrictions 
below. If the file is a permanent file which is already in the 


directory» thre tLocK function is ecuivalert to the RELEASE 
function. , | | 


A file way rot have its name ertered in the disk directory if 
there is alreacy a file by that name in the directory. A user 
who attempts to CLOSE LOCK a file» the name of which is atready 
in the directcry causes what is knowr as a “Lupticate Library” 
condition. The program will be sespended at this point and an 
operator messece descrithing the cenflict will be displayed.  § The 
operator must intervere at this pfcirt and cause the existing file 
to be removed» or instruct the MCP tc change the CLOSE LOCK 
commuricate to a CLOSE PURGE cr CLOSE RELEASE. Syntax 3s 
proviced to allow this. | | | | 


The REMOVE bit in the adverh is interded to be used on disk files 
anty» Its function is to atlow temocrary disk files to be Closed 


with LOCK without operator interventione It operates in a manner 
sSimiler to CLOSE CLOCK except thet af a Duplicate Libdtrary 
condition arisese the existing file is removed from the directory 


and the disk space assigned tc it is returred to the available 


table automaticattly. The furncticn is derformed by the MCP with 


no operator intervention required. The new disk file 1s then 
entered into the directory and certrcl is returred to the user. 


The CRUNCH bit in the adverh was oricinally irtended for use by 
the ccmoilerse. This restriction is ret enforceds however» and it 
may be used by any program whose source tLangquage includes’ the 
construct necessary to set the Fit in the Communicate format. 
Its purpose 1s to return any disk thet was recuested but not used 
by the file to the available disk table. The unused disk must. 
lie teyond the Endtof~Fite pointer fcr the file and the file may 
have no more than one disk area assigned tao ite When a Close 
with CRUNCH operation is performed on a file» always in 
conjurction with the LOCK bit» the ruster of segments per area in 
the file header is modified by the Close routine such that tt 1s 
exactly equal to tke amount of disk used. The header is then 
written to disk» per the LOCK bit» and the unused space is 


returred to the system. 
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The AG FEWINC bit when set 18 applicabte to magnetic tape files 
only. it causes the magnetic tape te be positioned immediately 
beyond the Last label record writter. The urit remains assigned 
toa the program and is not avaitable fcr use by anyone else. The 


user then ‘has the ception ot oneninc another fiie in the forwara 
direction» thus creating or continuing a multi~file taper or of 
openirg the file just written as input tn the reverse direction. 


The IF NOf CLOSED bit attows a user to close a fite that is 
alreacy closed. Ordiraritly» this is @ erograsrming error and will 
result in the user's being terfiinatec by the WMCP» as described in 
a pricr paragraph. This bit is merely a means of avoiding 
termiration. | 


File Information Stocks» I/N descrirters and tuffer areas require 
substantiet amounts of memory. The ROLLOUT bit tn a CLOSE 
Commuricate nas provided to allow a user to temporarily close a 
file» Leaving the asseciated device essigned tc the program» and 


nave the FIG storec on disk so that it dces not waste memory 


SPpacee When the file ts reopened» it is merely a matter of 
readirg the FIE in from disk» updatire certair fields therins and 
proceedinge JThis is cften quicker than recreating the entire FIB 
and it elimigtes the oossibility cf another program gaining 
coneret cf the pe pheweras device in the interig. 3 


The TERMINATE kit ir the CLOSE adverb is set. when the MCPs 
ter@iration routines call the Clese routine. This occurs only 
when a program terminates» normatly or abrormally» and the 
peripheral devices are still essignec to the froagram. 


Ihe MCP insures that the external names associated with a file 
assigred to disk are proper names wher the file is closed. When 
a compiler closes the code file it has generated» the external 
names of the file are inserted by the Close routine based upon 
information supplied by the user ir the Canpnile Control Card. 
Also» the MCP will not allow a disk file to he closed with LOCK 


with a blank multi-file {[D. The irternal nage of the file witl 
be inserted in FPB.MFID and an operater Besse Wilt be printed. 


wheh. this is attempted. 


The FPB.LOCK boolean» if set» will cause the LOCK bit in the 
CLOSE adverb to be turned on when the file 1s closed» previded 
the TERMINATE bit is also sete This causes the file to be 
entered in the disk directory and was added as an aid to 
debugqging-=» Cccasionally» when a pregram has a fatal errors disk 
files that the program was using et the time gre helpful to _ the 
object programmer in determining what caused the errore Locking 
the file in the directory enables the frogrammer to Look at the 
data Fe was processing when the errer cecurred-. 
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The CRUACH bit in the adverb witl te turned on automatically by 


the MCP if the file teing closed is < backup file» a pseudo~deck 
or a code file. The LOCK bit will Ee turned on if the file is a 
backur file or a code file and if it should be entered in the 
directory. This latter case cér only te determined: from 
information ccentained on the Compile card which is not readily 
available to the compiler. | : . 


Any file which was opened with the cutput bit set in the OPEN 
adverbs» any file to ‘which the user Ray have Feen issuing ARITE 
commuricates» requires some special attention by the MCP during 
the Close procedure. Since physicat I/0 operations happen 
asyrckronously with the user progran» output 1/0 operations may 
have teen initiated or marked reégdy for initiation and be 
incoaplete or not even in process at the time the MCP receives 
the CLOSE communicate. fhe actual Clcse operation must therefore 
wait for the completion of ail cutgut 1/0 operations associated 
with the file that is being closed. 


Input files present some simitar problems. Since all of the 


user's buffers are filled when the file ts opened» provided the 


file is accessed serially» and stince the MCP attempts to stay 
ahead of the user program in initiating [/0 cperattons» as soon 
as the user has read ail of the recorcs from 3 buffers physical 
1/0 cperétions may be in process of marked ready for inittation 
when the file is closeds. In the case of an irput file» it is not 
necessary for the MCP to weit for I/C completion. Any operations 
which have not been physicatly initiated may be cancelled by 
remcving them from the channel chair. The MCP must wait for the 
completion of any 1/0 operations that are already physicaity in. 
process» but this 1s a relatively shcrt time period. 


In the case of Sequential I[/0 and Celayed Rancom disk files» ithe 
aqata tn the buffer may have been altered by a Write operation 
fron. the user tut the I/o descrigtor fay not yet have been marked 
ready for initiation. The Close. routine wilt insure that all 
such buffers are actually written.ta cisk pricr to the completion 
of the Close operation. Similarly» tor serial» blocked output 
filese the user may have done several write operations but not 
yet filled an entire tuffer. The I/C descrirtor in this case 
also will not yet be sarked ready fer initiation but the buffer 
will contain data which must he written to the physical media. 
The Close rcutire witht initiate etl such operations and insure 
that they are compteted satisfactorily a allowing the file 
te be closed. | | | 


In order for the events describec in the preceding paragraph to 
occurs the physical media must remain accessible. in other 
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words» if the unit goes not ready end there are I/0 operations 
which must be completed before a Close can occurs the program 


will remain in a watting condition until the untt goes back to a 
ready condition and the necessary cperations are complete. 
Keyboard syntax is provided» however» to allow the operator to 


override this restriction. The syrtéex should be used only when 
the user orcgram is being aborted. The output data in the 


buffers wilt be lost if the syntax is invoked and the data in the 
file will be suspect. Further» if the device is a magnetic tape» 
the MCP will not be able to write clcsing tape marks and _  tabels 
on the media and an I/AN error will result when the tape is read. 


Possitly» no I/0 error will result» which may be worse. 


The Close routine next begins operations which are dependent upon 


the type of device assigned. In the case of a card reader which 
is clcsed by a users the device may contain cards which have not 


yet teen read ty the program. The MCP will czguse the cards to be. 
passed through the reader» stopping when the device goes not 


ready or when the next control card is encountered. 


In the case of a reader-sorters code segments would have been 
marked nonmovertayable in memory wher the file was openede These 
code segments wtil be marked overlayable by the Close routines 
proviced the user who issued the CLCSE is. the sole user of a 


sorter. Reacer~sorter files may crly be closed when the flow of 
decuments is stopped. Also» they way onty be Closed with 
Release. Tre MCP will interpret all Close aperations on sorter 


files to be Close with Release» regerdless of the setting of the 
RELEASE bit ir the adverb. - 7 


Sy tere the most complicated processing cccurs when the file is 
assigred to diske If the file is a sultipack file» the Base Pack 
must be onw~tine at the time of the Close. The Close procedure 


will rot proceed past this noint if it is not. 


The cp next attempts ta do the LOCK function described 
previcuslye. New disk files will be entered in the disk 


Girectory» provided there is no file with an identical name 


already in the directory. 


Existing. files in the disk directory cannot be removed under any 
circumstances if they are ir use.» Sinmitarly» files classified as 
"System™ files cannot be removed» even thcugh their user~count 
field in the disk header is zero. The MCP cece file being used 


ts ar exaecle cf such a filee Existing files wilt be removed by 


the Close routine if the REMOVE bit is set in the CLOSE adverb or 
the RW¥OV system option is set» if the Close rcutine encounters a _ 
‘duplicate file in its processing. If neither of the above. 
conditions are truer the program wilt be suspended at this point) 
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and the operator must intervene to resolve the conflict. 


If the file is a permanent file ard 1f the user has added records 
to the file while it was open» the end-of-file pointer in the 
file reader will be adjusted ty the Close routine. ! 


If the PURGE bit 1s set in the advert and the file is a permanent 
file or if the file was temporzry anc is being Closed with 


Release» the disk spéce used by the fite is returned to the 
available table. 


If the file teing clesec is assignec tao taper. the Close routine 


writes tape marks and labels on the tape. Alsoe the Close 


rcutire sends a rewind descrintor to the unite if not prohibited | 
by the type of Close being performed. | 


The irformatian in the IOAT is updated by the Close routine. 
Test and Wait for Ready [/0 descriptors are reminitiated» if 


appropriate. ALl of the user’s I/€ cescrinotors are removed from 


the I/0 chaine 


Information in the FPS is updated and stored on disk in the 
workirg copy cf the FPB. Firally» the memory assigned to the 
file is returned to the systen"s available memory. Control is 


returred to the user through the normal processor queue 
mecharis@s-. 7 


POSITION (MICRO MCP CEACKUP FILES QNLYI2 


CT.VERG 19 

CT.CEJECT FILE-NUMEER 

CTeADVERB BIT , 
CO REPORT & RETURN TO USER ON EOF 


1 REPORT & RETURN TO USER ON PARITY 
2 REPORT & RETURN TC USER ON INCOMPLETE I/0 
3-7 ) 
& POSTTION ‘10 END CF FILE 
9 CT.1 CONTAINS PRINTER CHANNEL NUMBER 
10 CT.1 CONTAINS RECCRD COUNT AS A FIXED NUMBER 
_ 11 CT.1 CONTAINS RECORD NUMBER DESIRED 
CT.1 CEFINED EY BITS IN CT.ADVERB 
REINSTATESMSG.PTR WALUES 
( GOCD POSITION 
1 END CF FILE COR EAC OF PAGE ON PRINTER) 
Z Iv ERROR 
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The POSITION communicate atlows the user to change the physical 
and logical position ona file. It is used with serial files 
only» of courses The file may be assigned tc disk» tape or to a 
printer. The communicate is iqnorec if the file is assigned to 


any other device... 


Positioning a printer file witt te discussed first. Tf the 


POSTTION communicate is directed to <~ printer files CT.».1 will 


contain either a channel numbter which will ccrrespond te a punch 
in a carriage control tape» or a nurber which witl specify the 


number of lines tte printer should be spaced~ If bit 10 in 
CT.-ACVERS is on» CT.1 with be assugec to ccntain the channel 


number. If the bit ts off» CT.~1 will be assumed to contain the 
number of Lines. : : | 


The Position routine will always space the printer the number of 
lines recuested. Cue to the design of the 81000 Printer 
Contrectls» it spaces tre printer two lines per descriptor and» if 


the number of lines requested was an odd number» issues a space. 


cperator for cne line to complete the operations. If a channel 
twelve punch in the carriage control tape is reported anytine 
dGurinc the spacings Endwof=page is reported to the program when 


the cperatton is complete. It is therefore possible» though 


highly inefftctent» to cz2ause several pages of paper to he passed 
through the crinter with one POSITICN communicate. End-of~page 
is always reported to the user» if it was reported to the MCP» 
regardless of whether of rot he has included code to handle the 
Situatione Frograms are not automaticatiy discontinued if there 
is mo such codes 


lf Clel contains a channel numbers and if the channel number is 


less than twelvep the routine cernstructs and sends an [/0 
descriptor tc cause the printer tc space to the requested 
channel. If the channel number if CT.~1 is twelve or greater» a 


messace is printed on the SPO and the communicate is ignored. 


Wiehe “some restrictions» disk files may be pesitioned forward or 


backwatd é specific. rumber of records cr they may be positioned 
to a specific record humber within the file or they may be 


positioned to the end of the file. The file may be opened for 


input or for cutput but it tay not te anened for both. 


Random disk files and files with variable length records may not 
be positioned at all. Attempting te cc so will result in the MEP 
-autométicatly discontinuing the prograte - | | | 


Input disk files may be positiored toa the erd of the files but 


May nct be positioned beyonde Atterpting to co so will result in 


“ 
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the file being positioned to the era of the file. Output disk 


files may be positioned beyond the ercuwof-file pointer but may 
not te positioned teyond the dectared ohysical bounds of the 
file. The “*dectared physical bounds" cf a file are the number of 
records per area declared times the number of areas in the file 
declaration. 


Files may not ve positioned to é&@ negative record number. 
Attemcting to do sec will cesult in the file being positioned toa 
the tierst record in the file automatically. 


In atl cases mentioned aboves the first bit ir the adverb must be 


Sete Attempting to position a. cisk file to or beyond the 


end-ct~file pcinter or to the first record in the file or a orior 


recorc witl result in the MCP autcmaticatly discontinuing the 
program if the Report and Return EOF bit is not set. This is 
applicable recardtless of whether the file is opened for input or 
output purposese | | : : 


Files assigned to tape may alsa te positicned forward and 
backwerd»s provided the file does rot contain variable-length 
recorcse Attempting to position suck a file will result in the 
progrém being ciscontinued by the MCP. #£Aiso»s tape files wilil Se 
positioned to the first record ir a file or to the 
end~cf-the-file» provided the first Fit in the adverb is set» in 


the same manner as disk files. 


In order to furction properly» the MCP maintains a record count 


for ell tape files on a “ner reel" basis. When the Position 
routire receives the communicate» it first computes the record 
number desired by the programe If the record count desired 


exceecs the current record count» the tape is positioned in’ the 


forward direction to the desired reccrce 


The reccrd count fcr <eny reel of tape is set to zero when the 


file is apened. [his is applicable regardless of the type of 
Close previously performed on the file» if there was a prior 
Close. Hence» when a tape reel iS opened itn the reverse 
direction» Record Gne is actually the last physical record on the 
tapee The "forward" direction is therefore defined to be the 
direction that the tape is currently bkeing passed. Hhen a file 
is opened reverses a "Backspace" operation will cause it to move 


towarc the physical erd of the reel. 


Tape fites may not be positioned tc the erc of the file if the 
file is apenea output or if if 15 cpered reverse or tf it is nee 
an ANSII~Labeled' tape. When a Position to endtof~file occurs» 


| the record count field naintained by the MCP will be Lost» since. 
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the I/0 ewerstor addressed to the urit will be a "Space to Tape 
Mark". The record count field must therefore be recovered from 
the ending tabel and ANSII tabetls are the only labels which 
guarartee that a record count field is present. 


The 81000 tape subsystem is capable af spacing tape one physical 

record per I/C operation or to a tape marke It is not capable of 
spacirg for a specified nuaber of physical bhlecks with one 1/0 
descriptor. ences spacing to a specific record occurs one block 
at a timee Irrecoverabte [/0 errors encountered on any of the 


blocks will result in the pregram's being automaticatty 


disccrtinued ky the MCP if the secerc tit ir the adverb is not 
sete If the second tit is set» the I/C error wilt be reported to 
the program and the position communitcate will ce terminated. At 
this point» tre record count field weintained by the MCP will not 
be reliable. : a | 


if a tape mark is erccuntered while the MCP is spacing the _ tape 
to a specific record» Enc-of-~File will be reported to the progran 
if the first tit in the adverb 1s SE€te The program will be 
autometicatty discontinued if it is rote | oe | 


FILE PARAMETER BLOCK (FPB) 


en ea ae ren «ae Ne emp a em 


ACCESS 


— CTAVER2 11 
— CT.GBJECT «=o FILE. NUMBER 
CTeADVERB BIT 


0-10 - 
11 O=READ 
L=WRITE 
CT! RECEIVING FIELD 3127 LENGTH © | 
162 . - RECEIVING FIELD 3ASE RELATIVE BIT ADDRESS 


The ACCESS.FPB Communicate allows the user access to any at his 


File Parameter Blocks. the working cepy orly of the FPB may be 


accessed by this communicate. Tne FFB is reac directly from disk 
into the user's run structuree The address end size passed in 
the communicate must lie wholly within the run structure. The 
prograw wilt be automatically discortinued by the MCP if this 
rule is violated. | 


Inforgation is not formatted by the wCP. If the FPB definition 
in the MCP is changed for any release cf the software» it is the 


users resporsibility to make corresponding changes in. his | 


om 


programe 


The ccemmunicate operation is ignored if. CT.CBJECT specifies a 


file which is non-existent or if the user attempts to read less core 
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than S6 bits of an FPB. 


Changes made to the FPB while the tile is cpen will not be 
effective until the file ts opened <éegain. Due to the fact that 


the Close procedures use fields tr the FPF» changing a File 


Parameter Stock while a file is caper may result in unpredictable 
errors and even system halts. . 


ACCESS FILE INEQRMATION BLOCK CFIBD 


CT.VERE 12 


CIT.CRJECT FILE»-NUMBER 
—CT.J ADVERB RIT 


o=10: = 
11 FORMAT 
Q=CHARATTER 
| L=UINARY 
CT.1 RECEIVING FIELD 311 LENGTH | 
CT.2 RECEIVING FIELD 3ASE RELATIVE BIT ADDRESS 


The ACCESS.FIB communicate does not really access the entire FI. 
it returns orly the End-of-File poirter and the type of hardware 
device assigned to the file. It returns these items itn either 
binary or decimal formate The Encotof-File pointer is twenty= four 
bits cr eight kbytes. The hardware tye 1s six bits or two bytes 


respectively. 


Programs will te automatically discertinued if the receiving file 
is not wholly contained within the pregram’s run structure. An 
ACCESS.FIB communicate for a fite that is not open will he 
ignored. | 7 . 


RE CE oh a re 


CT.~VERB 43 


CYTe-CAJECT BASE RELATIVE BUT ADDRESS OF 76 BIT FIELO IN FURMAT 
: | 4 5171S - 


24 BITS BEGINNING ADDRESS 
24 PITS ENDING ADORESS | 
24 BLIS RELATIVE CISK ADDRESS 


This communicate is issued by progra#s which are written in SDL 


and which include paged arrays onty. The SDL Compiler generates 
code which Manages the Dagqed array sface and this communicate 15 


the means whereby it. transfers infornztion in the paged ger ays to 
and from disk. | : | 


OF 
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The area described by the fields tistec above must tlie wholty 
withir the prcocram’s run structure. Violation of this rule will 
result in the automatic discontinuaticn of the rrograme 


| The relative disk address passed must lie within the disk overlay 
- area allocated te the programe. This has heen discussed 
| previously under program BOJ facilities. | | 


Due tc hardware Limitations» the cverlay area can be no~ smaller 
than S6 bits. | | : 


This communicate is mot used hy CQOBCL>» RPG or any other procram 
written in a source Language other than SDL. a 


This communicate uses the program's cverlay descriptor in the Run 
Structure Nucleus. The program is ¢leced in the WAIT.~Q@ until the 
I/Q operation initiated by the orocecure goes to completion. At. 
| that time» cantrol is returned tc the orogram through the norwal 
e. processor queues. : “a | 


‘AGCESS DISK EILE HEADER (CEH) 


CT.VERE 14 ne 

CT.CBJECT EASE RELATIVE ADDRESS CF 30 CHARACTER FILE IDENTIFIER : 
PACK.ID CAT MFID CAT FID 

CT.ADVERS BIT 


ae ae 0-5 )—l- 
a 7 | — «& OVERRIDE USERCODE NAMING COKVENTION AND SECURITY 
fo REPORT SECURITY VIOLATION 
&-9 
10-11 O=WRITE 
- -L=READ 


2=READ & FORMAT IN BINARY 
i .. oe a 3=READ & FORMAT IN CHARACTERS | 
: » « Sie9 . RECELVING FIELD 3IT LENGTH | 


(CT.2 «RECEIVING FIELD BASE RELATIVE BIT ADDRESS 
REINSTATEsMSG.PTR VALUES. | | 
i | GQ COMMUNICATE COMPLETE * 
. tp  & E 2 FILE NCT PRESENT CR SECURITY VIOLATION AND 
| ; Soe | | CT-ADVER3 BIT 7=0 © | 
2 SECURITY VIOLATION ANO CT.ADVERB BIT 7=1 


This communicate allows. the user access tc. cisk file headers — 


contained in the system*s disk cirectory. The receiving or 
_ sendirg file described by CT.~1 and CT-2 must lie within the 
© progrém's erur structure. If it dees not» the program will he 


automatically discontinued by the MCP. The field in the run 
structure which specifies the file identifier must he exactly 
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chines characters in length and fust conform: to the fixed ‘Hotwat 
described in the Communicate layout eheve. , 


This communicate has four variations és defined by CT~ADVERB. Tf 
CT-ACVERB contains a zero or a ones the serding or receiving 


fietc is assumed to correspond exactly to the current definition 
of a cisk file header. The “currert™ definition means the 


definition used ir the actuat CP that ts handling the 


communicate operator» and not the definition used in any 
subsecuent MCP. | | : 


If CY-ADVERB is set to zero» certain fields are moved from the 
progrém"s run structure to the actual disk file header = and 
written to the disk directory. Cnty Setecedd: fietds may be 
writtens those not selected are igrcred. 


If CT.ADVERB is a ones information is moved directly from the 
file header to the receiving fieloc specified. The move is 


teft-justified with zero fill. The ertire file header may be 


read in this mannere 


If CIeADVERS is a two or a three» the fields listed in the table 
pelow only are moved to the program*’s run structures. The 
fcrmatted move also cccurs left~justified with no filling. If 
the receiving field is not sufficierttly Longs the move is merely 


truncated from the righte 


FIELD NAHE | , LENGTH LENGTH 


| (BITS) CCHARACTERS) 
OPEN. 1YPE 24 1 
NOUSERS CNuaber of Users) 24 2 
RECORD»SIZE © a | | 24 4 
RECORCSePER-BLOCK a: 8 | 24 4 
EQFePCINTER 7 | | 24 8 
SEGMENTS »PERSAREA | | 24 8 
USERS.OPEN. eu rest. - | 24 1 
FILE. TYPE | ™ 24 2 
PERMANENT = SS ie 24 4 
BLOCKS.PER-AREA ei | 24. ns) 
—AREAS.ROST (Requested) 24 » a 
AREA.COUNTER 24 3 
SAVE FACTOR a 7 _ 24 3 
—CREATION.DATE | | | : 24 a 
ACCESS.DATE CLest) : | - 2a 5 
RECSSIZE a | ye ies Ae 
MPF (Multi-Pack Fite) = — oe ot 1 
PROTECTION | ae 7 a 4 
PROTECTION. Io | - | | ae me 


GALE Set oe eee Gs SER SS ees Ce eee testes ace 
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If the file is not present in the disk directory» the program is 
notified by inserting a one in the RS»«REINSTATE.MSG.PTR. In 


either cases control is returnec to the program through the 
nortal processor queue mechanisme ; 


FINOZHCDIEY coy ") 


CT.VERB 15 
CT~CBJECT INVOKE AUMBER & PATH NUMBER OF THE PATH~NAME 
CT.ADVERB ET 


¢ RETURN LIST HEADS CREORG CNLY) 
1 RETURN LOGICAL ADCRESS CREORG ONLY) 
2 DMeSTATUS FORMAT 

O=BINARY 


1=4-8TT DECIMAL 


2 ON EXCEPTION 
j i 
5 MODIFY 
6-10 SELECTION EXPRESSION | 
O NEXT. 
1 PRIOR 
2 FIRST 
3 LAST 
& NEXT AT 
5 CURRENT 
GAT i 
- | 11 DATA SET SELECTIEN EXPRESSION 
CT.l DM.STAIUS REGISTER 81T LENGTH | 
CT.2 DM.STATUS REGISTER BASE RELATIVE SIT ADDRESS 
CT.3 DATASET RECORD WORK AREA BIT LENGTH © 
CT.4 DATASET RECORD WORK AREA BASE RELATIVE BIT. ADDRESS 
C1.5 SEARCH KEY CCAT OF COMPCNENT NAMES) BASE RELATIVE BIT ADR. 


CT2£€ INVOKE NUMBER & PATH AKUMBER OF LATASET“NAME | 


Refer to PsSe 2212 5470. 


SIORE COM) 


CT.VERE 16 
~—CT~CaJECT INVOKE NUMBER & PATH NUMBER 
- os 3 CSUBSET IF INSERT) 
CT-ADVERG EIT 
INSERT 


OE ol 


DM. STATUS. FORMAT 

O=BINARY 

1=4-BIT DECIMAL 

ON, EXCEPTION | | 

BEGIN TRANSACTICH CNOT INSERT) ; 
INCLUDES.LISTsHEACS CREORG ONLY) 
END TRANSACTION CNGT INSERT) 


nu Ww 
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7 NO AUDIT (BEGIN CR END. TRANSACTION ONLY) 
é SYNC CEND TRANSACTION ONLY) 
9 _ | | 
10 STORE INDEXES OALY CREORG ONLY) 
11 PSEUDC CREATE CRECRG ONLY) 
Clsi . OM.STATUS REGISTER SIT LENGTH | 
CT.2 . OMSSTATUS REGISTER BASE RELATIVE @1T ADDRESS 
CT.2 — DATASET RECORD WORK AREA BIT LENGTH CNOT INSERT) 
| INVOKE NUMBER & PATH NUMBER OF DATASET CINSERT) 
CT.4 DATASET RECORD WORK AREA BASE RELATIVE BIT ADDRESS 


CNGT INSERT) 


Refer to PeSe ?212 5470. 


CT.-VERB 17 | ; 
CT.~CRJECT INVOKE NUMBER & PATH NLMBER 

* CSUESET IF REMOVE) | 
CT»~ADVERS BIT 


| gc = REMOVE 
| | 1 | ~ 
2 “DMeSTATUS FORMAT 
O=BINARY 
1=4-B1IT DECIMAL 
3 ON EXCEPTION 
4-41 = 
CT.1 DOM»STATUS REGISTER BIT LENGTH 
| . | —CT.2 DMeSTATUS REGISTER BASE RELATIVE BIT ADDRESS 
© CT.2 DATASET RECORD WORK AREA BIT LENGTH CNOT REMOVE) | 
. | | INVCKE NUMBER & PATH NUMBER OF DATASET CRENOVE) 
fo CT.4 DATASET RECQR) WORK AREA BASE RELATIVE BIT ADDRESS 


CNOT INSERT) 


Refer to PeSe 2212 5470. 


jo Oo CREATE/RECREATE & 

fo | ciVens 18 

,  CT.CBUECT INVOKE NUMBER & PATH ALYBER. 
: — CTLADVERB SIT | 


Q ; — 
1 RECREATE 
2 DMeSTATUS FORMAT 
O=BINARY 
1=4-BIT DECIMAL 

5: ON EXCEPTION: 

Gil = 

CT. | DMeSTATUS REGISTER SIT LENG TH 


CT.2  —-- DMw STATUS REGISTER BASE REL ATIVE BIT ADDRESS 
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CT.3 DATASET RECORD WORK AREA BIT LENGTH 


CT.4 DATASET RECORD WORK AREA BEDE RELATIVE BIT ADDRESS 


Refer to P.eSe 2212 5470. | 


 SHLICHsTAPESDIRECTION 


CT.VERE 19 
CT-CBJECT FILE.NUMBER 
CTeADVERS = elt 

0-7 NOT USED 


E-11 0 = READ FORWARD 
1 = READ REVERSE 
4 = WRITE 
REINSTATE.MSGPTR VALUES 
0 GOCD SWITCH | 
1 FILE NOT OPEN | | 
2 WRCNG DIRECTION CR NOT A TAPE FILE 
3 END OF FILE | | 


This cperator was added to facilitate the implementation of the 


Tape sort feature. It has found use tn other applications since 


that tive. Essentially» it merely changes the direction of a 
tape file without time~consuming Close and Open invocation. 


There is no way that this communicéte can cause discontinuation 
of a program. All errors are merely reported to the programe 
The file way te changed from input tc output» provided it is not 


being read in the reverse directione ODirection may be changed on 


the same communicate which changes the [70 modeew In other wordse 
a file may be changed from input eérd reverse to output and 
forward with one communicate. = | cs 2 


Buffers are filled by the MCP as a furction cf this communicate. 
No fields in the FIB are changed» howeverj Consequently» use of 
this communicate is not practical on tlocked files. ) 


This cogsunicate will not function if one of the. file? S butters. 
has already encountered the phystcat end of the file. | 


TERMINATE CSTOP RUN) 


CTAVERB = 20° 
This Communicate calls the Terminate Procedure directly. | The 


JVerwirate Procedure’ is atsc callec wher “a program is being 


re ggicea sag eaueiel a aa gatens ae ens cce 
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discertinued. There is very Little divpacencs between a normal 
teratrate procedures where the routine is catled via a 


Commuricate and an abnormal ones where ree procedure is calted by 


ve MCP to discontinue a ‘Program. 


Programs may not be terminated if they are using a reader~sorter 
and the device is operating. In this case» the terminate 
rountine will wait until the flow is stopped on the sorter and 
then proceed with the termination. This is due to the fact that 
High Priority Interrupts from the scrter can onty be handted in 
code written exclusively for that purpose... At any rate» att of 
this will be transparent to the user ard the program wilt be 
termirated» though not necessarily at the time the Terminate 


__ Procedure is first invoked. 


A similar situation exists if the program has Data Management 
operations in processe I[/0 Complete on such an operation can 
only be handled by Data Management code» and the Terminate 


Procecure will be forced to wait fer completion of any such 


operations. 


The Terminate Procedure may also have to wait for Rolt~in and 
Roll-Cut operations to he camoleted.- The procram must be present 


in wesory before it can be terminatece 


As mentioned previously» all of the conditions listed to this 
point are transparent to the user. The Terminate Procedure has 


its own mechanisms for waiting for such events to be con erect. 
No action is required on the part cf the users 


The queue of keyboard messages entered via the Accept response 


will be purged cf any messages irterded for this program at this . 
point. Refer to the Software Operational Guide explanation of 


the "AX" messace for details on this queuée 


At this point» the Terminate Procedtre will wait for any code or 
data everlays which may be in process to go ta completion. | The 


Termirate Procedure» if it must wait for such an events» yields 


contrcl to the outer Loop of the WMCP. The Procedure witlt be 
continued when the I/0 goes to completion. | | 


Any 1/0 operation which was initizted by the program and which 


did not use tre normal File I/0 mecternism will be hatted = and 


delinked from the channel chain at this pcint. | Exasples of such 
operations are disk I/0 initiated ky the Cisk Initialization 
utilities and all Data Communications 1/0 operations- Temporary 
disk storage cbhtained by the MCP to execute the program is 


eee 
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returned to the disk available table. 


The Terminate Procedure next proceeds te elees: aii the files 


which are asscctated with the oprograsg. and which are not. yet 


closed. A file which is closed by a user with no bits set in the 


Close Adverb cr with the NO REWIND tit set in the adverb is. not 


considered closed by the MCP. The urit» in these casesS»s remains 
assigned to the program» even though there can be no [/0 in 


process for the file. The unit must be returned to the List of 


available resources when the program termirates. Files are 
always Closed with Release by the Terminate Procedures except 
when the file is assignec to disk anc FPB.LOCK is set. 


The Terminate Procedure next performs those functions associated 
with Wemaory assigned to the program. The code segment dictionary — 
user count is decremented. If it becomes zero» memory occurpies 

by the code segments and the segmert dicticrary is returned to 


the available memory List. Similarly» the user count for the 
Interpreter used by the program is decremented. If it becomes 
zero» memory cccupied by the interpreter and its segments is aiso 
returrede If the interpreter was partiatily or totally resident 
in M~Memorys it 1s remavede This way result in a change in the 
mode of MW- Memory management. If sc» it is performed at this 
pointe | 


Similar functions are performed on ary Intrinsic Code the program. 
may have been using. The user count for the Intrinsic File and 
for the Code file itself are decremerted anc stored an the disk 
file header in the disk directory. 7 


If the Log option is sets» the Log its updated at this point. tn 


addition to the type of termination» a count of code overlays» a 
count of data cverlays» the current time: and date and the amount 
of prccessor time used by the prcgra@ are stored in the Loge 


The program*s overlay descriptor is resmaved from the disk chains — 
a SPQ message is printed if the EQJ cption is sete and if this 


program was executed by another using the PROGRAM.CALL 
cogmunicate» the calling prograg ts #arked ready to rune Memory 


occupied by the program*®s run structure is returned to. the. 
available pocl. The number of jots running is decremented. AD 
bit is set which will cause the next execution of the QOUTER.LOOP 
to check the active job schedule. _ 


If sary programs are in the Waiting schedute. and are waiting for 


the successful termination of this prcegrams they are moved to the. 


Active schedule» provided this is a rormal termination. If this 


program was a “Compife and Go" or a "Compile and Save"™»s the code 


SEE TEE YR UU SC rr ere eer TIE ERE eT seta ra em ST SESE te et 
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file generatec is placed in the active schedule. 


FREE £0é2 


CTaAVERB 21 
CT.OBJECT INVOKE NUMBER & PATH NUMBER : 
CTeADVERB BIT 7 


0-1 
2 DM.STATUS FORMAT 
O=BINARY 
1=4-BIT DECIMAL 
3 ON EXCEPTION 
4-11 - 


OMeSTATUS REGISTER BIT LENGTH 
DM.STATUS REGISTER BASE RELATIVE BIT ADDRESS 


6 668 
fA.) 


oie wp) 
ce | 


Refer to PeSe 2212 5470. 
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CT.VERB 22 
CT~CBJECT BASE RELATIVE BIT ADDRESS uF WHERE TO PUT THE RESULT 
 CTZADVERS ETT 
C L=DATE REQUESTED 
i-2 FORMAT 
0 YY/DDD CJULTAN) 
L MM/DD/YY 
2 YY¥Y/MM/DD 
3 DO/MM/TT 
374 REPRESENTATION 
O BINARY 
1 4-317 DECIMAL 
2 8-BIT DECIMAL 


3 L=TIME REQUESTED 
6-7 FORMAT 
CG COUNTER 


1 HHSNM2SS.S C24-HOUR CLOCK) 
| 2 HHEMM2SS.5 TT Ci2-HOUR CLOCKs TT=AM/PM) 
6-9 REPRESENTATION a 
O BINARY 
1 4-BIT DECIMAL 
2 B-BIT DECIMAL 
10 1= TODAYS. NAME REGUESTED 


- yt - 

NOTE © TODAYS-NAME RETURNS 9 CHARACTERS LEFT JUSTIFIED 
FORMAT > BINARY : 4-EIT OECIMAL 8&=BIT DECIMAL 
-YY/CDD CJULIAN) 749=16 8412=20  16#24=40 


MM/CD/YY 4454+7=16 | Bt&+8=24 © 164#164+16=48 
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YY/MM/OD 7+ 445=16 8thFG=24 | 16+16+16=48 
DD/MM/YY 5+4+7=16 B+64=24 © 164#16+16= 48 
COUNTER 20 24 7 4B 

 HHEPMSS5S5.5. 5+ €4+64+4=21 B+h+Gth=28 16#164164+8=56 
HH3MM2SS.25 TT AF 6t6t+4416=36 dtbtbth+16=44 1641641648416=72 


TOLAYS.NAME | | 72: ©9 CHAR® LEFT JUST.) 


CT.VERB 23 
CT»COJECT BASE RELATIVE ADORESS CF 
6 BYTE UNIT MNENCNIC 
| OR 
| 4 I/O DESCRIPTOR 
CT»ADVERB VALLE : 


0 ASSIGN UNTT TC THIS PROGRAM. 
1 RELEASE UNIT 
Ya INVALID 
ei LINK IN THE I[/0 CESCRIPTOR AND INITIATE 
4 INVALIO 


REINSTATESMSGsPTR VALUES | 

IF CT»ADVERB=0 THEN 

PORT» CHANNEL AND UNIT CF OEVICE REQUESTED 
PORT BIT C3) 
CHANNEL BIT C4) 
FILLER BIT (1) 
UNIT BIT C4) 

ALL OTHER CASES 
0 00D COMMUNICATE | 
1 OLSPATCH TG IAVALID PORT OR CHANNEL 


This coamunicate 1s intended for inwolant use only. Anyone 
cutsice of Santa H8arbara Plant whe attenpts to use this 
commuricate does so at his own risk. The communicate format and 
function may be changed from time to time. No notice of such 
change wiit te suoplied toe any user crior te one: change.- Such 


information will be available on recuest.. 


Released MCP*s will not Athos a Write descriptor to be initiateg 
on system disk. Attempting to do sc will result in the program's 


pe} ng DS~ed-s 


The ta: does not assure that the A arc 8 addresses in the I/0 
Descriptor are bounded by the prograa'ts Base/Limit registers. Tt 
is the programmer's resporsibility tc co thise | Failure to do so 
will result in unidertifiable system halts. | 


To use this communicates» the procrammer shoutd first issue it 
with CT.ADVERB set to zero and. CT-OBJECT pointing to a 


iid 
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Sixmcharacter unit mnemonic If the ‘requested. unit is not 
availeble for any reasons the calling progras will be DS~ed. I f 
the unit is available» it witt ke assigned to the cailing 


program. [It is possitle to read any unit without requesting that 
the urit be assigned to you. 


After the unit is assigned to the prcgram» the communicate may he 
issued with CI.ADVERB set to two or threee The MCP copies the 
I/0 Cescriptor outside the base-limit before it links into the 
chaine When the I/G completese the IN-ACTUAL-END and I[0.RESULT 
are acved back into the base"tinit areas. When the 1/0 operation 


is completed» the Is descriptor is removed from the associated 


channel chain. In order to aaain execute the I/Q> the progran 
must issue another communicate with CT»«ADVWERB set to two or 
threee ) 


The program should issue the cammuricate with CT.ADVERB set to 
one before it goes ta end- of-jab. 


It shculd be emphasized that this coa@unicate was added to the 


MCP for purposes of onwtline pack initialization only and 1s 
intended for use only by that prograr» in the form supplied by 
Santa Barbara Plante Requests for maintenance or support from 
any cther source will be ignored. 


edt ae ous ih oat Lee 


CT.VERB 2h 
CI.CBJECT LENGTH OF TINE IN 1OTHS OF A SECOND - 
FLNCTION PROGRAM IS PUT TO SLEEP FOR SPECIFIED LENGTH OF TIME 


Zip 


—CT.YERB 25 
CT.COJECT - 
CT.ADVERS = - 


CT.] MESSAGE AREA ALT LENGTH 
CTe2 MESSAGE AREA BASE RELATIVE 8117 a 
REINSTATE»MSGePTR VALUES | 
—C NO ERRORS IN ZIP TEXT | 
i ZIPPED INVALID COATROL CARD 


This communicate provides a means for programs to pass control 


cards and keyboard messages to the MCP.  |$There are no 
restrictions an the messages which way be passed. No messages 
are returned to the program by this procedures — the only 


inforsation returned is an indiceticn of whether or not the 


syntax of the controt instruction was valide 


ea oe ae Pe OE ce ce en ea ee 
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Any program placed in the schedtle as a result of a control 


messsqe received from a ZIP Ccmmunicate will execute 


asyncfronousty with and indenencertly of the program which 


executed the ZIP» unless programmatic means for synchronizing the 
two Erograns are provided ir the erecramse 


If the control instructions passea via the ZIP communicate are 


invalids a message is printed on the SPO to inform the system 
operator of the occurrence. This is necessarys since invalid 
control instructions can result ir incerrect operational 


behavior. 


CT.VERS” 26 
CT»CBJECT = 
 CT.ACVERS = GIT 
| Qo RETURN TF NO MESSAGE 
11. ““e 
CT-1 MESSAGE AREA BIT LENGTH - 
CTe2 MESSAGE AREA 3ASE RELATIVE SIT ADDRESS 


a nn ee MSGeaPTR VALUES 


0 MESSAGE OF LENGTH ZERO 
QFFFRFEFS NO MESSAGE PRESENT 
ANY OTHER VALLE LENGTH OF MESSAGE IN BITS 


This coamunicaste was provided as a means of implementing the. 
COBOL ACCEPT verb. Its use tis not restricted to programs written 


ina particular paniguagsee it may be used by any programe 


The receiving field must tie withir the bourds of the program's 


fun structure. The program wilt be forced to wait for. an 


operator resporse if bit one in the édverb is a zero and if there 


is no message in the Accept Queue for the program. Control is. 
returred— to the program through the rormal precessor queues when 


a pesnenat from the operator iS reéeceivede. 


Nessaces are moved to the receiving field tleft-justified with 


blank fill. 


 CTe VERB oT 
CTI.CBJECT - 
CIeADVERB EXT 


ee ee ~~" Ee Oe ee, oe ee Te eS. ae eRe EE ee ee i ie Path ag age ge TRE SES Nr oad Ses ae Ct, RRR me Ome Oe Ee, SOO ee ee te a has a ee egere nt OF ake gk kee yo Rpm b es eS CURA Tk ge cen en A etary pant ee Solar Yee att” cee ren ee nS 
SES es Rs Ba Sp fens S 2 pas ae oie een pot SRN a me Soe San 3 a SOE ce ee is 2 - 
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1 G=CRUNCH BLANKS CUT OF MESSAGE 

| | . « L=PRINT MESSAGE AS IS 
CTel MESSAGE AREA BIT LENGTH | 
CT.2 _ WESSAGE AREA BASE RELATIVE BLY ADDRESS: 


This communicate was provided as a means of implementing the 


COBOL DISPLAY verb. Like ACCEPT» it may be used by any program. 


It serves porety to print the messace descrited by CT.1 and CT.2 


. aon the SPC. 


if bit eleven in the adverb is set» the MCP will reformat the 
entire message such that nonwblark fields in the message are 
separated by no more than one tlanke This is merely a 
converience fcr the user programaer which gay be used when the 


spacirg of tte words in the wessage upon the SPO is not 


leportant. 


Haxehs iss 
ct. VERB 28 


This communicate is not implemented. If receiveds it is ignored 
and ccntrot is returned to the user. 7 | 


SORT EANOLER 


CTAVERB 29 
CT.QSJECT BASE RELATIVE ADDRESS GF SORT INFORMATION TABLE 
CTeADVERB BIT (12) 
o 1 - SORT.RESTART 
2- SORT~DUPCHECK 
3—- SCRTW1.PID 
4 = SORT.W2.PID 


, I712 FILLER | 
CYT.1 BASE RELATIVE BIT ADDRESS OF SORT. KEY TABLE 
 CTe2. | INPUT FILEsNUMBER OR ACLDR OF MERGE.INPUT. TABLE If MERGE | 
CT.3 QUTPUT FILE.NUMBER 
CTe4 TRANSLATE FILEsNUMBER CR NoT Lt) 
~CT.6 DATA. ADDRESS CDELETE.KEY.TASLE)D 


CT.7 OIF CSORT.W1.ePID 2= W1IPIDeFLAG) THEN 
7 — DATAs*ADDRESS CW1.PIE) ELSE O 


— CTe8 ss CSORT.W2.PID t= W2.FIDeFLAG) THEN 


CATASADDRESS CW2-PIC) ELSE O 


This” communicate provides a means for eRe user program to catt 
the (scert Intrinsic. For details cor the implementation» refer to 
the Broper sort or erde Product Specification. : s 
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SQL IEACE 
CT.VERB 30 


CTSCBJECT TRACE FLAGS 


This communicate is used by all interpreters which include’ Trace 

capabilities. | Its use is not restricted. to SDL only. The 

communicate is merely a means of turrirg the Trace on and off. 

The print line is passed via a type 61. interrupt from the 

interpreter. The code invoked by this interrupt. is tittle more 
than a4 call on the SOL Read/Write Precedure in the MCP. 


EMULATOR TAPE eens 


CT. VERB 31 
CT.OBJECT fFILE.NUMBER 
CT-ADVERB BIT. an 
Te a a | C-2 £OPp.cCOoDdEe 
ers a it | 7 | 0 = READ 
| | | | — WRITE 
SPACE 
REWIND 
TEST | 
3-6 (OP.CODES VARIANT | | 
| a 7 = REVERSE CREAD» SPACE)» ERASE CHRITED > 
| ; oe | TESToWAIT»READYsNOToREWIND CTEST) 
, | _ ONE.RECORD CSPACE)» TAPEoMARK CWRITE) 
TESTe»WAITeNOTeREADY CTEST) 
CODePARITY CREAD» SPACE» WRITE) 
| NOISE CREACDs SPACE) © | 
-§ = NOT USED | | 
1 SCHEDULING VARIANTS 
FETCH.RESULT 
DONT»WAIT 
REPORT AND RETURN ON 10 ERROR 


3 
4 


N 
how vw how 


is} 


wi 


i 


aon ul 
wou il 


pead 
oS - 
oo oi 


i} ane Mist: .-* USER TAPE BUFFER B11 LENGTH _ 

rn re Py ee LSER TAPE BUFFER. BASE RELATIVE ADDRESS ee 

Lee | erat... USERS ERROR MASK CBIT SET IMPLIES. USER WILL HANDLE, THE 
an ee CORRESPONDING ERRORY 


oe 
om 
eee 


(MAY NOT USE) 
(MAY NOT USE) 
NOT READY 
PARITY CNOT ON TEST) 
ACCESS CNOT ON TEST) 
TRANSMISSION CCN TEXT ONLY) | me os 
END.OFsTAPE 2 2 7 ne oe ee 
- ~BEGINNING.OF.TAPE SS 40% ae 
WRETESLOCK.OUT ar ar re 
END»OF FILE (NOT ON TEST)» UNITsPRESENT CON. 
TEST) yt ey 


WO tN OU EWM Ft oO 
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10 REWINODING | 
11 TIME.0UT CNOT CA TEST) 
12-16 CMAY NOT USE) 
17 SHORT*RECORD 
1€ LONG. RECORD 
19 DROPOUT 
20 INT TIATELATE 
24 CMAY NOT USE) 
22 TRANSMISSIONERROR.MEC 
22 — TRANSMISSION.EFROR.MTC 
CTa4 BASE RELATIVE ADDRESS OF USER*S 48 BIT RESULT 


BIT 0-23 OF RESULT CONTAIN THE RESULT DESCRIPTOR 
PIT 24-47 OF RESULT CONTAIN THE ACTUAL LENGTH 
REINSTATE.MSG.ePTR VALUES 


Q = RESULT RETURNED 

1 = TO.ERROR 

2 = RESULT NOT AVAILABLE 
This communicate Was added $C that the Emulators of 
secona~generation hardware produced ty Santa Barbara Plant might 
be operated under control of the MCP. It was necessary to add a 


new ccmamuricate tc do thisre since fregrams written for these 
machires routinely manipulate magnetic tape in manners which 
violste the rules of tha MCPs togqical I/0 mechanisms. The 
nortat file mechanisms in the MCP» which were promulgated upon 
the specifications of the COBEL tlanguager are certainly 
iradecuate tc allow all of the many tape operations which were 
common tc second generation machineSe 


Essentially» the procedure builds ar I/0 descriptor according to 
the specifications passed hy the communicate format and tnitiates 
ite The Emulator program is not allewed to execute until the I/0 
cperation goes to completicn. The procedure 15 re~entered at 
completion of the operation and the program is then allowed to 


contiruee 


The procedure first tests to see if the file is Open. If it is 
nots the Oper procedure is called directly from the communicate 
and control is returned to it when the open corpletes. At this 


points the procedure continues provided the open was successful. 


if it was not» the emulator program uculd have been placed in one 

of the processor queues and marked waiting. In the Latter case» 
the communicate procedure merely returns control to the cuter. 
feop cf the MCP. 


The procedure next performs minor editing on the files passed in 
the ccmmunicate format. If the cperetor request involves a data 
transfer» the buffer area described aust Lie wholly within the 


bounds of the user's run structures Due to hardware 
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restrictions» certair variarts ard combinations thereof are 
invalid for certain operation codes. The variants here are those 
passed in bits three through seven of the communicate adverh. 
Validity of the variants is checkec by the procedure. If the 
user has violated either the bounds check or the variant check» 
the program is automaticatty discontirued by the MCP. 


The procedure next constructs an I/0 Descripter which corresponds 
to thét requested by the usere The I/C Descriptor is outside the 
users run structures A full tape tile FI8 is allocated» atang 
with space for one I/0 descriptor» ty the Open Procedure. This. 
is dene even though many of the fields in it are not used by the 
Emulator Tape Handler routines directtly- Most of the fields are 
required Ey the Close Procedure. ; = | 


The requestec [/0 operation is then iritiatec and the program ts 
marked waiting for its completion. Control is returned to _ the 
outer taop cf the MCP at this pcint and the MCP is free to 
service other userse - 3 a | 


When the I/O coperatior completes» the procedure is again invoked. 


It tirst moves the result descriptor received with the I/0 
concatenated with a twenty~four bit field which will specify the 
actual length of the operation just ccemeletea- The Length of the 
operation is specified in bits. Alsc» prior to doing the move of | 


the resutt descriotors the procedure verifies that the receiving 


fielc is within the run structure of the program. If it 1s not» 
the program is automatically discontirued. : 


[If the exception bit is set in the result descriptors the 
procecure determires if the excertior condition is one that the 
user has incluced code to handie hitself. If it is» controt is 
returned to the user through. the normal processor queue 
mecharisiie If the user does not hzve code tc correct the error 
himselfe the procedure calts the PMCP*s I/C Error procedure 
directly. 1/G Error will then retry a number of times and 
eventually return controt to the Esutator Tape Handler. If the 
error was irrecoverable» the progras is discenttinued» Otherwiser 


contrel is returned to the usere 


COBOL PROGRAM ABNORMAL END 


~CT.VERB 32 
This coamunicate was added so that job streaming may he © 
termirated at the discretion of the user. It functions exactly | 


as the STCP communicate does except that instead of a standard 
End-of~Job messages it causes “COBCL ABNORMAL END™ to be printed 
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on the SPQ. Alsoe any proarams that are in the Haiting Schedute 


waitirg for this job to finish witl not be moved to the active 
seueueer by the abnormal termination. | 


SORT EQu 
—CT.VERE 33 


CT-CBJECT FILE-NUMBER 
CTeADVER® CLOSE FYPE 


CT. END~OF~FILE POINTER 
CT.2 RECORD SIZE 
‘This communiczete serves to terminate» in a normal manners the 


Sort and Merce Intrinsics and to return control to the calling 
program» For details on its operaticrs refer to the appropriate 
sort cr Merge croduct specificaticne. : | 


EREEZE/THAW RUN STRUCTURE 
CT.VERB 25 
CT.CBJECT BIT O CHIGH ORDER B17) 
O=THAW 


Depencing upon the functions being performed by a user programs 
it may not be permissable for the WCP to change the. memory 
location of the program's run structure cr to roll it out to 
disk. The most cbhvious examrele cf this 1s the Disk 
Initialization Utilities. which have actual I/0 Descriptors 
within their run structure. There are several other such caseSe 


The field in the Run Structure Nucleus» RS» TEMPORARY oF REEZE » 
gives notice to the MCP"s Retkl Cut procedures that this run 


structure may not ce moved. This communicate provides a 


programmatic means of bumping anc decrementing that field. 


COMPILE CARD INFORMATION 


CT.VERB © 36 | | 
4A BITS — SOL DESCRIPTOR CWHERE %C PUT INFO) IN FORMAT : 
| | 16 BITS=LENGTH 
24 BITS=ADDRESS | 
RETURNS COMPILE CARED IAFOQ IN FOLLOWING FORMAT = 
#CHARS INFOQ | 
20 ORJECT NAME 
0? EXECUTE TYPE * 
10 PACK. NAME OF TEE RUNNING PROGRAM 


SSE LORE OS eee Tp) 2 tena 
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30 INTERPRETER NAME OF THE RUNNING PROGR AM 

10 INTRINSIC NAVE CRACK. g FAMILY) | 

02 PREORITY 

06 SESSION 

C6 JOB NUMBER : 5 beac oe, Se 

20 1ST & ZND NAMES OF RUNNING PROGRAM ~ 

C7. CHARGE NUMEGER | Re ge 

G1 FILLER: | 

36 BITS DATE COMPILEL a a 

04 B81TS FILLER : Ne 

10 USERCODE | : 

10 PASSHORD 

C4 PARENT JOB NUMBER. | 

20 PARENT QUEUE FCENTIFIER 

Cl LOG SPO | 

04 SECONDS BEFORE DECAY 

01 PRIVILEGED 


This communicate returns selected fields from the working copy of. 
the Program Pzrameter Block to the user's rur structure. The 
receiving field described by tne SEL Descriptor must tie wholly. 
within the rur structuree The oprecram will be automaticaily 
discontinued if it does not. The fields returned are presented 
in the fixed format shown in the table above.” 


DYNAMIC MEMORY BASE 
—CTSVERE 37 


VALUE ITS RETURNED IK COMMUNICATE MESSAGE POINTER AS 
SELF RELATIVE DESCRIPTCR 


This communicate returns the relative address of the dynamics or 
overlayable»s area in the run structuree  [t is intended for use 
by prcegrams written ir SOL only. | : 


MEMORY DUMP IO DISK 


CT.VERB > 38 
USED BY ALL LANGUAGES» INCLUDING SDL. 


This communicete causes the program's run structure “and other 


pertirent information to be dumped to disk and locked in the 


directcry with a unique name. The informatior may be processed» — 
formatted and printed later by a norgal state program written ad 
that Se Paes 


Programs which are atready in the precess of terminating may not. 


be dumped. This is acadenic in this case» howevers since a _ 
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progréem which was terminatirg could rat issue the communicate. 
Programs which are rclled out to disk will be rotted back itn and 
dumpece via an operator"s actions fravided sufficient memory is 
available. Again» if the prograw were rolled out to disks Tt 
could not possibly have issued the communicate. 


The amount of cisk which will be required to contain the dump 
file usuatly exceeds by a considerable margin that required to 
contain just the Base/Limit area of the program. In addition to 
the run structures the dump file wilt also contain the File 
Dicticnarys» the FIB*s and buffers» the Data Dictionary and alt 
data segmentse the code dictiorary and the code segments which 
are present in memory at the times and other miscellaneous 
inforwation. If sufficient disk is not available» a message will 
be printed on the SPO and a ore will te returred to the program 
in RS»*REINSTATE»MSGeFTR.»~ The procgras will be allowed to continue 
processing- : 


The format of a dump file is as foltcws? 


1. A "Pointer™ records which is described below. 

Ze The program*s run structure and Run Structure Nucleuse. 

cm ihe? Dees Cictionary. 

4 ew ery: aaeS segment in the di ceeoscers Segments which are 


rot in memory wittl be cariec to the dump file from their 
lacation on diske | 


5. The File Cictionary. 
be Each FI8 and its associated I/T Descriptors and bufferse 


this includes att fites that are open and those that are 
closed with no form of release. 


fe The working copy of the Progras Parameter Blocks 
68 The working copy of the initial scratchpad settings. 
9e The working copies of att File Parameter Elocks- 


10. If the program is written in SDL» the LAYOUT.TABLE} 


Contrel is returned to the program thrcugh the normat processor 
queue mMechanisme Actually» the program is marked ready to run 
after the scratchoad is copied. 


The fcermat of the *Pointer® record is: 
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DUMPFILE-NUMBER BITC24) | 
TIME.CF.DUMP © BIT(C36) % Julian Date plus Time 
MCP.DATE | BI1€16) 2 MCP Versior Date 
RELEASE MCP BITC4) 
LIMITeREGISTER BITC24) : 
DATAjDIC.~PIR BITC24) % Relative Disk Address 
| CATA»SEGSwjPTR BIT(C24) 2% Relative Disk Address 
| FIE-CIC.PIR © SI1¢24) % Relative Disk Address 
2 FIBePTR BITC24) 2% Relative Disk Address 
PPE ePTR HITC24) % Relative Disk Address 
NET@CONTROL-«MACRO BIT¢4) z 1 if Data Communications Handler 
| ; MCPSRELEASE*LEVEL § BITC16) | 
= | 7 LAYOUT~TABLE.PTIR  S817FC24) 
| «LAYOUT. TASBLE.SIZE BITC 24) 
DUMP.SYSTEM.IC : BII¢c1i2) 


GEI SESSION NUMBER 


CT.VERB 39 
CT.-CH8JECT SESSION IS PUT INTO RS. REINSTATE. "SG. PTR 


DCeINIVIATES 10 
CT»VERE 49 
24 EITS PORT 
24 BITS CHANNEL 
26 BITS EASE RELATIVE ADORESS CF 1/0 DESCRIPTOR 


This communicate provides the capability of initiating I/70 
descriptors on the data commnuniczetions equipment which may he 


attached to a system. The I/0 descriptor itself if constructed 
by the prograg» which is usually the Data Communications Handler 
progréem generated ty the NOL Coapiler. This ts not a 


2 requirements» however» and no test tor this condition is made by 
- the ccde in the MCP. The communicate operator may be used by any 
:  progréaa . whose source language cortairs the proper syntax. 


A The program will be automatically discontinued by the MCP if the 

ye requested I/O control is not a data ccrmunications control or if 

eS the ccntrot is already in use by another program. Also» if the. 
address of the I/0 descriptor does ret lie within the program's 

run structure or if the progra#® attempts to initiate an I/0 

descriptor with the “high priority irterrupt request” bit set» 

the program will te automatically disccntinued. 


After the editing described above has been performed» the 
requested operation is initiated.  Centrol is returned to the 
user through the norgal processor dqueuve Hechanisme The prograam 


om 
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1s not forced to. wait for the ccapletion of the operation 
inittateds control is returned immeciately after the initiation. 


NOLZMACRO COMMUNICATES 


CT.VERB 41 

CT.CBJECT INDICATES FUNCTION 

DESC1. BIT 17°48 MESSAGE AREA 1 

DESC2 BIT 49-96 MESSAGE AREA 2 | 

QUELE-PIR BIT 97-106 REMOTE FILE NUMBER CR STATION NUMBER 


PLWRITE 
CT-CBJECT = 11 
DESC1i. RESULT AREA 
DESC2 ~DC.WRITE MESSAGE | 
NCTE? NUMBER AT SUBSTRCDESC2s€s2) IS MESSAGE TYPE 


40=FINISH OPEN 

41=NOL/MACRO PRESENT 

42=ATTACH STATIONS 10 REMOTE FILE 
43=CETACK STATIONS FROM REMOTE FILE 


QUICK CUEUE WRITE CREMOTE FILES? 
CT.CBJECT 12 | 


DESCi MESSAGE HEADER | 
DEST2 MESSAGE | | | 
RMT oFL REMOTE FILE TO WHICH THE MESSAGE IS DESTINED 


QLICK QUEUE WRITE CSTATION NUMBER 


CT~CBJECT 13 


CDESC) MESSAGE HEADER 
DESC2 FESSAGE 


SFeAR STATION NUMBER 


CT-VERB 42 


DESC = —- BIT O-47 DESCRIPTOR Te PARAMETER LIST. 
 -~PERAMETER LIST LAYOUT 
MODE BIT C4) 


0 SET ALL PARAMETERS IN LIST EXCEPT USERCODE AND. 
- PASSWORD. THESE MUST GE ‘SUPPLIED TO FIND © 
: CORRECT ENTRY. 
1 SET ALL PARAMETERS IN List EXCEPT ENDEX» “INDEX 
a MUST BE SUPPLIED 10 FIND ENTRY. 
2 SET OVERRIDE. USERCODE AND PASSWORD MUST BE. 


GURRGLGHS CORPORATION 
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10 


11 


i2 


INDEX 
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PRESENT TO FIND ENTRY. 

SET OVERRIDE. INDEX MLST BE SUPPLIED TO FIND ENTRY. 

ADD ENTRY» ALL FIELDS KAVE TO SE SUPPLIED. : 

DELETE ENTRY. USERCODE AND PASSWORD MUST BE 
SUPPLIED TO FIND ENTRY. 

INITIALIZE ALL OVERRICE BITS. 

CHANGE RY USERCODE.] ALL ENTRIES FOR A GIVEN USER- 
CODE CAN BE CHANGED WITH ONE COMMUNICATE. USER- 
CODE MUST BE PRESENT. PACK FIELD MUST NOT BE 
EQUAL TO ZERO TO CHANGE JT. CHARGE NUMBER MUST 
NOT BE EQUAL TO ZERO TC CHANGE ITo PRIORITY MUST 
NOT BE EQUAL TO ZERO TO CHANGE IT. 

DELETE ALL RECORDS FOR A GIVEN USERCODE. USER- 

CODE MUST 3E PRESENT. 3 

SET ALL PARAMETERS IN LIST EXCEPT USERCODE AND 
PASSWORD. ONLY USERCODE HAS TO BE SUPPLIED 
BECAUSE SEARCH STOPS ON FIRST ENCOUNTER OF. 

GIVEN USERCODE. | | 


CHANGE BY INDEX] INDEX MUST BE PRESENT. 


PRIORITY CAN BE CHANCED BY SETTING FIELD TO NON- 
ZERO» CHARGE CAN BE CHANGED BY SETTING CHARGE 
FIELG TO NONWZERT. FASSWORD CAN BE CHANGED BY 
SETTING PASSWORD TO KONWZERO. 

CLEAR PACK OVERRIDE FIELD FOR ALL OCCURRENCES OF 
THIS USERCODE. USERCCDE MUST BE SUPPLIED. 

CLEAR PACK OVERRIDE S811 FOR ALL OCCURRENCES OF 
THIS USERCODE}] IADEX MUST PE SUPPLIED. — 


EIT (10) 


USERCODE CHARACTER C10) 


PASSWORD 
PACK NAME 
CHARGE # 
PRIORITY 
PRIVILGD 
CVERRIDE 


WHEN SET RY PROGRAM CMCCE = Or 25 be Se Fo Br Yo 11)» 


THE USERCODE MAY OR PAY NOT CONTAIN PARENTHESES. 
IF PARENS ARE NOT FCUND» ONLY THE FIRST EIGHT 
USED. | 

hHEN SET 3Y MCP CMODE = 1) _— 

USERCCCE WILL ALWAYS CONTAIN PARENTHESES. 

CHARACTER (10) 

CHARACTER (10) 

BIT (24) 

BIT (4) 


BIT C1) 


BEIT ¢id 


REINSTATEsMSGePTR VALUES 


—CT.VERE 
48 BITS 


0 NO ERRORS. | | | 

1 ERROR ON INPUT: EITFER INDEX IS WRONG OR 
USERCODE/PASSWORD IS NOT PRESENT. 

2 "CSYSTEMI/USERCODE" FILE NOT IN "US" “SLOT. 


Kaho 
SDL DESCRIPTOR 


24 BIT LENGTH OF TEXT 


td 
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24 BIT BASE RELATIVE ALDRESS OF TEXT 


This coamunicate functions in a nanner similar to the ZIP 
communicate described previously» with one notable exception. 
The frogram which issues this ccrmunicate is suspended» and 
removed from memory» until the progras which is initiated by the 
commuricate gces to end-of~job.- This communicates thene provides 
amears for ore program to call arother and wait for its 
completicn. The text: which is addressed by the forty~eight bits 
passed with the commuricate should te valid MCP Controt Card 
syntax which causes the execution of 4 prografe | | 


Unfortunately» ro means are eprevided. for passing narameters 
between the two programs. involved. This can be done only via the 
File wechanisme of the MCP. The FILE Controt Cards described in 
the Scftware Cperational Guide» dees grovide some assistance in 
this area. : | 


The text passed by the communicate sust Lie within the program's 
run structuree The program will be gutomaticalty discontinued if 
it does note. No further editing is ferformed by the communicate. 
The program which issued the communicate is not informed of the 
va Reuey of the control syntax passec-. 


LCADADUMP MESSAGE 


CT.VERB 4h | | 7 
CIeCBJECT EASE RELATIVE ADDRESS CF MESSAGE 
CT.ADVERB BIT | | 
0 1=LOADED O=OUMPEC 
I-il = 


- This communicate causes the thirty bytes begirning at the address 


specified by CT.O08JECT concatenated sith either the word “LOADED*® 


or the word “CUMPED"» depending upor the setting of bit 1 of the 


adverbs to be displayed upon the SPO if and only if the LIB 


System option is sete Refer to the Software Operational Guide 


fer details or the LIB option. ALL renmblank EBCDIC fields in 


the g@essage will be shifted tc the left before Peenenns until 


they are separated by no more than one EBCDIC blank. 


COMPLEX WAII (MICRO cP2 


CT.VERE 0s AT 
CT.CBJECT NUMBER OF EVENTS — 7 - 
CT.ADVERB FIRST EVENT TO CHECK (CHECKED IN CIRCULAR 
te FASHION FROM THIS POINT). — : 
CT-1-ETC. BIT ENCCDED EVENTS CNUPBER SPECIFIED BY CT.OBJECT 
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O- 3 EVENT TYPE 
4- 7 EVENT PARAML 
B-15 EVENT PARAM2 
16-24 EVENT PARAM3 
EVENT TYPES: * i | 
GC ~ NULL - PARAM1s2+3 2 NOT USED : 
1 - SPO INPUT PRESENT - PARAM1»+263 2 NOT USED 
2 - TIME - PARAM1»253 2 CONCATENATED BIT 20 
FIELD CONTAINING THE LENGTH OF TIME TO 
WALT IN LOTES OF A SECOND 
2 - READ OK “PARANA: NOT USED» PARAM2: 
FILE NUMBER» PARAMS? WEMBER NUMBER TF FILE Is” 
Qe FILE-FAMILY | 
4 - WRITE OK - PARAMI1»2°3:2 SAME AS READ OK 
5 - QUEUE ARITE CCCURRED - PARAMI: NOT USED» 
PARAM2: FILE NUMBER OF G-FILE-FAMILY> 
PARAM3: NOT LSED a 
6 - CATA COMM IO COMPLETE - PARAM1>2»3: NOT USED 


REITASTATE MSG. PIR VALUES 
ZERO RELATIVE INDEX TO THE COMMUNICATE EVENT LIST ELEMENT 
WEICH IS COMPLETE 


MESSACE COUNT | 


CT.VERB 
CTeCBJECT 


C1.ADVERB 


CT.1 
CT.2 
| FUNCTION 


aetovery COMPLETE 


 CT.VERE 


Refer to PeSe 


48. 
FILE. NUMBER | 
0 DECIMAL FORMAT RESULTS IF TRUE 
COBOL C*PIC 999"). 

ELSE BINARY CBIT €24)) 
i-li | 
RESULT FIELD LENGTH 
BASE RELATIVE RESULT FIELD ADDRESS 
RETURN THE COUNT OF THE MESSAGES CONTAINED 


"IN THE CUECUETFILE SPECIFIED. IF THE OBJECT 


IS A QUEUE“FILE=FAMILY» THE COUNT WILL BE 
RETURNED AS A LEFT-JUSTIFIED ARRAY OF 
24-EI1T COUNTS» ONE FOR EACH MEMBER OF 


THE FAMILY. 


3% 


2212 S470. 


SEI A1I&12 UIE 2 


CT.VERE 
—CT.CEJECT 


St | 
FILE NUMBER 
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CT.AO0VERB COMMUNICATE LEVEL CMK 7.0 LEVEL=1) 
CTlel TOTAL ATTRIBUTES CMUST BE 1 IN 7.0) 


CT.2 — BASE RELATIVE ADDRESS CF ATTRIBUTE LIST. 


CHANGE -ATIRIBUIES 


CT.VERS 52 
CT-CBJEXT FILE NUMBER | 
CT.ACVERS COMMUNICATE LEVEL CMK 7.0 LEVEL= 1) 


(CT.1 TOTAL ATTRIBUTES (MUST BE 1 IN 70) | 
CT.2 BASE RELATIVE ADDRESS CF ATTRIBUTE LIST 
ACCESS sGLOBALS 
CT.VERB 55 an | — 
CT»CBJECT QO = CT.3 CONTAINS AN ABSOLUTE MEMORY ADDRESS 
1 o- HINTS. CTs? KILL BE USED AS AN OFFSET 


INTO THE FIELD 
2 = RS.NUCLEUS. USE OF CT. ADVERB AND CT.3 Is 
| DESCRIBED BELCh 
3 - IOAT. USE OF CT.ADVERB AND CT.3 IS DES~ 
| CRIBED BELOY 
4 = DCH.SCRATCH.HEF 
S = PACK.INFO TABLE 
ey . & = SPO.SQ 
CT. ADVERB SEE BELOW 
(CTe1 and Cfe2 A BASE-RELATIVE SOL CESCRIPTCR WHICH SPECIFIES 
| THE RECEIVING FIELD IN THE PROGRAM. THE FIRST 
| EIGHT BITS OF CT.1 ARE IGNOREL BY THE MCP 
CT.2 SEE BELOW 


Since HINTS actually begins at absolute Location zero» there is 
no functional difference between reading an absolute memory 
location and reading HINTS with an cffset. Both settings 0 f 
CT.OBSZECT are allowed to accomodéte pSee yore neue expars ion to 


the function af accessing HINTS» 


When reading Run Structure Nuclei» ell nuctei are returned if 


CT.ADWVERB is set to zero. The number of nuctet that are 
currently present in memory 15s returred as a selfrrelative value 


in RSeREINSTATEsMSGoPTRe ALL of the ruclei will be copied to the 
receiving fielc in the program in the order that they are linked 
in wewory and up to the Limit cortaired in the size specification 


jn CT.e1e If the nuclei of all executing programs are transferred | 


te tke receiving field before it is exhausted» the remaining 


porticn of the field witl be set to Elanks. 


To access the Run Structure Nucleus cf one perticular executing | 


programe CT»~ACVERB should be set to cne and the job number of the 
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program should be contained as a twerty-four bit binary value in 
CT.3. If C%te3 contains zero» the nucleus of the requesting 
program will he returned. If tre nucteus of the program 


specified ty CT.~3 is rot in memory fcr any reasons the receiving 
field wiii be set to a@FFFFFF2 anc fitled with blanks and a 
self-relative © value of one. will. be returned in 
RS»«REINSTATE.MSGoPTR. | 


When reading the IQAT» if CT»~ADVERB is set to zero» CT.~3 will be 
used as an offset into the ITOAT and the remaining portion of the 
table will he transferred» up to the limit specified in CT.1. 
The value of CY¥.~3 may be zero» af courses» and the entire table 
may be transferred. If CT-ADVERS is set to one» CT.3 witli he 
assumed toa contain the twenty-four bit birary value of a file 
number associated with a file which the program currently has 
open. AllL of the TOAT entries whict follow the associated entry 
may be transferred» depending upon the value contained in CT.el. 
If the file is not open or is not presert in memory for any 
reasor» aFFFFFFa@ wilt be transferrec» the remainder of the 
receiving field will be set to blérks and RS»REINSTATE.MSG.PIR 
witli be set to a selfrrelative value cf one. | 


If CT.~ADVERB is set to a value of twe when reacing the IQAT» the 


lowscrder twelve bits of CT.~3 witt be assumed to contain a_ 
Port/Chanret/trit combination in the following format: 


Eits 12 7 14 Port 
Fits 15 = 18 Channel 
Bits 19 ~- 23 Urit 


The MCP will scan the IOAT for the entry associated with the 
Specified unit and wilt return that entry plus all subsequent 
entries up to the limit of the [QAT cr that specified in CT.%. 
If the specitied unit is not present in the IOAT» the MCP will 
set the receiving field to @FFFFFFa2 foltowed by blanks and wilt 
set RS»~REINSTATE.MSEePTR to a self-relative value of one. 


INDEXED SEQUENTIAL POSITION 

CT.VERB 56. - 

CTe-CBJECT FILE NUMBER 

CT.ADVERB BIT. 

| 20 «Ge = | : . 
1 REPORT TO USEF ON PARITY 
2 - — 
3 . RESULT MASK FIELDS PRESENT 
45500 = -_ 2 3 

6-7 RELATIONAL OPERATOR 


0 EQUAL TC ; 
1 GREATER THAN 


CT.1 
CT.2 
CT.23 


—CT.4G 


C7.5 
CT.€ 
CT.7 


C1T.1. 


CT.2 


CTe2z 
CTe4 


CT.5 
CT.6 


CT.7 
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—PeSe 


NOT LES THAN (> 1 =) 
SELECTION CONCITION 

NEXT 

PRIOR 

FIRST 

LAST 

NEXT AT 

CURRENT 

AT 

RANDOM 


a een Cea eeny 


LENGTH OF RESULT MASK | 
ADDRESS OF RESULT MASK 


STRUCTURE NUMBER 
KEY ADORESS 
KEY — 


37 
FILE 
BIT 


8-190 


7 


INDEXED 2EQUENTIAL READ 


CT. VERB 
CT.C8JECT 
CT.ADVERB 


NUMBER 


REPORT TO USER ON EOF 
Seon! fO USEF ON COR LTY 


RESULT MASK FIELDS PRESENT 


RELATIONAL OPERATOR 

0 EQUAL TC 

1 GREATER THAN. 
2 NOT LESS THAN (> 1 =) 
SELECTION CONCITION 
NEXT 

PRIOR. 

FIRST. 

LAST 

NEXT AT 

CURRENT 

AT 
RANDOM 


INOUE WNP OM 


LENGTH OF RESULT MASK 

ADDRESS OF RESULT MASK 
LOGICAL RECORD LENGTH 

LOGICAL RECORD ADDRESS 
STRUCTURE NUMBER | 

KEY ADDRESS 


B1000 MCP II 
2212 5462 CE) 


BURROLGHS CORPORATION 


Clel 
Cis2 


C1.3 


C1.4 
C1T.5 
CT.6 
CT.7 


Cial 
CT.2 
CT.3 
C124 
CT.5 


on 


CTf/ 
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INDEXED SEQUENTIAL WRITE 


CT.VERB 
CTeOBJECT 
—CT.ADVERS 


38 


FILE NUMBER 


Bit 


60 


ma 


2 
3 
4-11 


REPORT TO USER ON EOF. 
REPORT TO USER ON PARITY 


RESULT MASK FIELDS PRESENT 


LENGTH OF RESULT MASK 

ANCRESS OF RESULT WASK 
LOGICAL RECORD LENECTH 

LOGICAL RECORD ADDFESS 
STRUCTURE NUMBER 


KEY 


ADDRESS 


UNDEXEL SEQUENTIAL REWRITE 


CT.VERE 
CTsOBJECT 
CT.ADVERB 


59 
FILE 
sit 
0 

1 


gee 


3 
4-1] 
LENG 


NUMBER 


REPORT TO USER ON PARITY 
RESULT MASK FIELDS PRESENT 


TH OF RESULT MASK 


ADDRESS OF RESULT PFASK 
LOGICAL RECORD LENGTH | 
LOGICAL RECORD ADDRESS 
STRUCTURE NUMSER 

KEY ADDRESS © 


INDEXEC SEQUENTIAL CELETE 


1 REPORT TO USER ON PARITY 


3 RESULT MASK FIELDS PRESENT 


CTeVERB «BO | 
CT.CEJECT FILE NUMBER 
CT.ADVERB © BIT 

: 0 = 

2 - 

| 7 4-1t 7 | 
CT.1 | LENGTH OF RESULT MASK 
CT.2 ADDRESS OF RESULT MASK 
CT.3 | sc - | 
CTo4 se oa ee 
CT.5 STRUCTURE NUMBER 


CTl-6 | KEY ADDRESS 
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RELATIVE I/0 COMMUNICATE - START 


CT.VERB 61 
CT~CRJECT FILE NUMBER 
CT.ADVERB Git | 
0 REPORT TO USER ON EOF 
1 REPORT AND RETURN TO USER ON PARITY 
2 REPORT AND RETURN TO USER CINCOMPLETE I70) 
3 RESULT MASK FIELD PRESENT 
4-5 0 = 
4-7 RELATIONAL OPERATOR 
0 EQUAL TC | 
1 GREATER THAN © 
2 NOT LESS THAN 
_ | | g@-“11 7 . 
CT. LOGICAL RECORD BIT LENGTH : 
CT.2 | LOGICAL RECORD BASE RELATIVE BIT ADDRESS 
CT.2 ACTUAL BINARY DISK KEY CRELATIVE KEY) 
| SUPPLIED BY USER 
CT.4 3 - | | | | 
CT.f LENGTH IN BITS OF RESULT MASK FIELD 
CT.6 | BASE RELATIVE ADDRESS OF RESULT MASK FIELD 
REINSTATE.MSGePTR 
C ' GOOD READ 
1 END OF FILE 
2 I/O ERROR | 
3 INCOMPLETE I/C 


CACDITIONAL ITEMS FOR FILE STATUS DEFINED IN THE SEQUENTIAL 
FILES protean SPECIFICATION) 


RELATIVE 1/0 COMMUNICATE = WRITE 
CTaVERB —i(‘ws«éGP | 
CT.OBJECT FILE NUMBER 
CT.ADVERB BIT 


0 REPORT TO USER ON EOF 
1 REPORT AND RETURN TO USER ON PARITY. 
2 REPORT AND RETURN TO USER CINCOMPLETE Iv) 
3 RESULT MASK FIELD PRESENT | 
t ACCESS TYPE 
0 SEQUENTIAL CNEXT) 
i RANDOM CAT KEY). 


3 S11 - | 
CT.1 LOGICAL RECORD BIT LENGTH 

CT.2 | LOGICAL RECORD BASE RELATIVE 317 ADDRESS 
CTet : — ACTUAL BINARY DISK KEY FOR RANDOM OR DYNAMIC 


FILES CSUPPLIED BY USERS NOTHING IF IN 
, SEQUENTIAL MODE) 7 | 
~—6CTWS | LENGTH IN BITS OF RESULT MASK FIELD 


EE ne er Se CUE DP es Be ge Eee Dba Lene 
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CT.6 BASE RELATIVE ADDRESS OF RESULT MASK FIELD 


REINSTATEMSGePIR 


0 GOOO READ 

1 END OF FILE. 

2 T/Q ERROR | 

3 INCOMPLETE I/C 


~CACDITIONAL ITEMS FOR FILE STATUS DEFINED IN THE SEQUENTIAL 
FILES DESIGN SPECIFICATION) 


CT»VERB 
CT.-CBJECT 
CT2ADVERB 


CT.l 
CT.2 
CT.2 


CT.4 
CT.5 
CT. 


HELAIIVE 1/0 COMMUNICATE = SENEIIE 


63 
FILE NUMBER 
BIT. | | | 
Q REPORT TO USER ON EOF 
1 REPORT AND RETURN TO USER ON PARITY | 
2 REPORT AND RETURN TO USER CINCOMPLETE 170) 
3 RESULT MASK FIELD PRESENT 
hy ACCESS TYPE 
QO SEQUENTIAL (NEXT) 
tf RANDOM CAT KEY) | 
ak OS 


LOGICAL RECORD BIT LENGTH 


LOGICAL RECORD BASE RELATIVE BIT ADDRESS 


ACTUAL BINARY OISK KEY FOR RANDOM OR DYNAMIC 
FILES CSUPPLIED 8Y USERS NOTHING IF IN 


Senn Thee MODE) 


LENGTH IN BITS OF RESULT MASK FIELD 
JASE RELATIVE ADDRESS OF RESULT MASK FIELD 


REINSTATEOMSGePTR 


0 GO00 READ 

1 END OF FILE 

2 1/0 ERROR 

3 | INCOMPLETE Isc 


CADDITIONAL. ITEMS FOR FILE STAILS DEFINED IN THE SEQUENTIAL 
FILES DESTGN SPECIFICATION) 


THE REWRITE COMMUNICATE WILL BE abies THE SAME AS 
THE RITE» BUT WILL HAVE A OISTINCT MEANING IN LOGICAL 1/0 


BELAILVE Izo ¢ SMUNIES JE = DELETE 


CT.VER@ 
CTe«CBJECT 
CT. ADVERS 


PWN 


64 

FILE NUMBER 

BIT 
REPORT TO USER ON EOF 
REPORT AND RETURN TO USER ON PARITY 
REPORT AND RETURN TO USER CINCOMPLETE I/s0) 
RESULT MASK FIELC PRESENT 
ACCESS TYPE. 


Q SEQUENTIAL CNEXT) 


ae 
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: 1 RANDOM CAT KEY) © 
: S-1L* = : | 
7 CT.1 a. | 
i CT.2 - | | 7 , 
Cis3 ACTUAL BINARY OISK KEY FOR RANDOM OR DYNAMIC 


FILES CSUPPLIED BY LSERs ae If IN 
SEQUENTIAL MODE) . ; 


CT.4 
CT.§ LENGTH IN BITS QF RESULT MASK FIELD 
CT.6 BASE RELATIVE ADDRESS OF RESULT MASK FIELD. 
REINSTATEMSG.PIR 
be | 0 GOOD READ © 
as 7 | a | END OF FILE 
a | . I/O ERROR 


INCOMPLETE I/C | 
CACDITIONAL TITERS FOR FILE STATLS DEFINED IN ae SEQUENTIAL 
FILES DESIGN er ee amene. : 


RELATIVE I/0 COMMUNICATE = READ 


CTeVERE 65 


: — « CTACBJECT FILE NUMBER 

| ~—CTJADVERS BIT 7 

0 REPORT TO USEF ON EOF 

/ 4 REPORT AND RETURN TO USER ON PARITY 
| 2 REPORT ANO RETURN TO USER CINCOMPLETE 1/0) 
3 RESULT MASK FIELD PRESENT 

} | 4 ACCESS TYPE | 

i : | 0 SEQUENTIAL CNEXT) 

i | | | 1 RANDOM CAT KEY) - 

iz | 5-11." = 

| CT. LOGICAL RECORD BIT LENGTH - 

| CT.2 LOGICAL RECORD BASE RELATIVE BIT ADDRESS 


Cles ** ACTUAL BINARY DISK KEY FOR RANDOM OR DYNAMIC 
— FILES (SUPPLIED BY LSERS NOTHING IF IN 
SEQUENTIAL MODE) | 


CT.4 | 
£165 « — LENGTH IN 811S OF RESULT MASK FIELD 
CTe€ | BASE RELATIVE ADDRESS OF RESULT MASK FIELD 
REINSTATE. MSG.PTR 

0 _ GOOD READ 

a; a END OF FILE 
2 1/Q ERROR 
3 INCOMPLETE I/C 


CADDITION AL ITEMS FOR FILE STATUS DEFINED IN THE SEQUENTIAL 
FILES DESIGN SPECIFICATION) 


SEQUENTIAL RERRIIE CuMceD 


€ —  CTeVERB (CH 
| CT.CBJECT = FILE NUMBER 
CTeADVERB = BIT ) 
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CT.1i- 
CT.2 
CT.2 
CTA 
CT.5 
CT.€ 


REPORT AND RETURN TO USER ON EOF 

REPORT AND RETURN TO USER ON PARITY | 
REPORT AND RETURN TO USER ON ENCOMPLETE I70 
LENGTH ADORESS PART TS PRESEN FOR THE RESULT 
MASK 

4-1i °- 

LOGICAL RECORD BIT LENGTH 

LOGICAL RECORD BASE RELATIVE BIT ADDRESS 

RANDOM FILE ACTUAL BINARY KEY ~ 

LENGTH IN BITS OF RESULT MASK 

BASE RELATIVE ADDRESS OF RESULT MASK FIELD 


WAS oo 


INDEXEC/SEQUENTIAL OPEN 


CT.VERS 
CT.OBJECT 
CT./ADVERB 


CT.i 


CTez 
CTe3 


67 

FILE NUMBER 

BIT | 

0 REPORTFILE. VISSING 

1 REPORToFILE.~LOCKED 

2 REPORTsEXCEPTION CSECURITY ERRORS} 
3-11 = 


(THE OPEN TYPE IS TAKEN FROM THE FPB. ADVERB AND 


FPB.EXPANDED. ADVERB FIELDS) 

LENGTH OF USERC ODE sPASSWORD FIELD 

CIf OPEN.ON.BEHALF OF) 

BASE RELATIVE ADDRESS OF. USERCODE/ PASSWORD FIELD 
OPEN STATUS = RESERVED FOR THE SMCP TO KEEP TRACK 
OF WRERE 70 RESUME IF THE ENTIRE OPEN CANNOT es 
COMPLETED. 
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INJER=PROCESS CONFUNICATION 


A essage queue system has existed in MCP II since 1973. This 
section describes the current Queue implementation and the 
interfaces hetween the Queue system egrc other system software. 


The word "Queue” as used in this dccument» most often refers to 
the actual data structure maintained hy the operating’ System. 
This data structure is used as a means of inter process 


~~ COoMmmuricatione Queues may have varicus attributes just as files 


do« For exatwple», Queues may have two ten-character namese user 
counts» message counts» and so forth. The data structure is used 
to address a list of messages. This list gay be empty» <A Queue 
user tay add to the back or remove from the front of this List. 
The Queue may ke shared “" one or mere processes may put messages 
in the list and one or more processes fay remove messagese Only 
the CP may access the data structure directly. User programs 
must use ether mechanisms» which are censtructed from this data 
structures such as Queue Files or Resote Files. 


The design of the data structure (Figure 6871) was strongly 
affected by the need to reduce the ‘S-memory needs of queuese 
Reusable structures Like message buffers and message descriptors 
are pcoled for the use of the whole cueue systeme The memory 
space used [Cy empty message buffers and descriptors is not 


automaticality returned to the system. The Queue implementations 
rather» - retains them for later uses. This results in quicker 
allocation when this space is required again and in tess 


disturbance cf the working set of the code in the system. Since 
Queue Files ard Remote Files are unbleckeds their FIB"*s need not 


have buffers. This minimizes the amount of memory required to 


contain the FI8. 
QUEUE FILE FAMILIES. 


A Quere File Family may consist of a faximum af 1023 Queues» each 
having the same first name or MFID and the same attributes. A 
Queue File Fanily ts shown diagragwmaticatly ir Figure &-2. A. 


user program may READ a message from cre of the individual Queues 


in the fanily or it may request a message from any queue in the. 


fagily. On @ WRITE operations howevers the individual family 


crm ¥ Yew Denes SORTS GIR TRE UAL MET PER EE, EET RARER aE Ble eR tn a SE a 
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member must be specified. 


If individual Gueues of a Queue File Family are to be addressed» 
the irdividual member must te specified by an crdinal numberr or 
key» wuch like Switch Files in certair languages. A key of zero 


specified on a Read of a Queue File Famity means that the user 


will accept a message fron any of tre individual Queues which 
comprise the family. | | 


QUEUE DESCRIPIORS 


For a given Queue» the Queue name» maximum Length» pointers to 
first and last messages» etc» are stcred in the Queue Descriptor. 
The cescriptcr must be in memory curing the existence of the 
Queues. Users of the Queue are giver “Q"keys"s» which serve as 


pointers to the Queue Descriptor» when the Gueue File is opened 


and the user has specified the desired attributes of the Queue. 
For a Queue File> the Q-key is stored in the file*®s FIB. If the © 
Queue is empty» the 360~bit descriptor is. the onty memory 

structure dedicated sclely to the Queue. 


“GUEUE DISK 


Messages stored in a@ queue may resice on disk or in memory. At 
Queue creations an area of system cisk 1s cbtained for the Queue 
large enough to hold Q.MAX-MESSAGES cf size GeMAX.MESSAGE SIZE. 
These two attributes are normaity soecified by the users A Queue 
specified to contain a Maximum of 255 messages» each of a maximum 
size cf 200 bytes will reauire 255 *€€2004179) DIV 180) or 5196 


disk segments» where DIV denotes an Integer Divide operation. 


The required disk snace will be alticcated when the Queue is 


opened». prior to the time it is actually required. This is done 


to mirimize the processing required to store the message on diske 


Users who have minimal amounts cf disk storage available may 


contrcel the amount that is feauired by Queues by manipulating 


—6 Oe MAXAMESSAGES The disk space that is atlccated to Queues 15 
‘not tccked in- the directory. [If the system fails white Queues 


are actives the disk is returned to the available list during the 


ensuirg Clear/Start aperatiane Disk is always allocated to! 
 Queuess even if sufficient nenOny is available to contain the 
mex vale number of messaqgeSe | | : 


Queue messages are written to ite When a Message being put into 


a queue makes the count of wesseges i1n mremory equal to the 
attritute Q@.dLFFERS. When this situztion occurse a disk write 
operation on the fast message ir memory in the Queue its 
iriticted. This. will make one of the buffers available for an 


-ensuirg insertion in the Queue. There is one exception to this — 


We ras ee OR RE ig TN age, TM OS eta SL Re ec ga 
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 statenent. The disk Write operatior witl not be initiated by the 


Queue routines 1f the attrtbute SoEGFRERS. 49 equal to or greater 
than the attritute Q-MAX.MESSAGES.  $$In this case» messages 


associated with the Queue may orly be written to disk by the 


Memory Manaqement routines. The Meaory Management routires may 
write Queue messages to diSk anyti#e memcry is required in the 
system. This ensures that Queue messages will not fill memory to 
the pcint where thrashing occurs. 


When a user removes» or READS» a message from a Queue the first 


wessage in the Queue is transferred tc his Rur Structure and the 


nmext message in the Queue is exatirned to determine if it is on 
disk» If it is» a look-ahead disk Pead operation is initiated to 
minimize the time that the user wilt NAwe®: to wait for delivery of 
the next Queue wWessage. | | ; 


The 1/0 descriftors that are used for the disk Read and write 
operations just described reside ir the Queue File*®s FIB. For 
each gode of use» input or output» a program apening a Queue File 


is) given one I/0 descriptor. A file cpened input and output is 


given two I/G descrirtors. — {1/0 descriptors are shared among alt 
members of a Queue File Family» sc that ro Gueue File FIG wiil 
ever contain more thar two I/0 descriptorse 


MESSACE DESCRIPTORS 


The method of storing messages in the cueue is by means of a 
linkec list of Message Descriptors. Each Message Descriptor (MD) 
consists ef an 80-bit system descriptor and two tink fields» for 
a tctal of 128 bits eache- The system descriptor actually 


describes the message text» accordire to. norsat MCP conventions. 


To reduce checkerboardings MC's are allocated in blocks of ten. 
Assigning a Message Descriptor to 4 message is accomplished by 


searching the block(€s) of ten for an available MD. If none are 
available» memory space for an <ecditionel block of ten is 
obtdired via a call on the Memroy Managemert routinese The 


blocks of Message Descriptors are surveyed periodicalty te 


consolidate and returr unused blocks tc the system. At least one 
block is retained as long as any Gueues exist. ee 


ay 


MESSAGE BUFFERS 


If a eaeeedr message is in memory» the metory area which contains 


the message is known as a Message Buffer (M3). The MLeTYPE. field 


in the memory Link which descrites the area will be set to a 
unique value which denotes a Message Buffer. Ko Queue will ever 


Mit 
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have more than Q.HUFFERS messages in memary at any - timer 
including. those messages which are ir transit between memory and 
diske Actually» since the Memory Maragement raqutines are capable 
of writing Queue messages to disk anc removing them trom memory» 
the Gueue routines cannot auarantee that ary messages will be in 
memory at any guven times 3 


oueue ATIRIQUIES 


Im addition to attributes common to atl files» the user may 
specify two attributes whose interpretation has meaning for Queue 
Fites ontys: | 


le  GeMAX.MESSAGES - the maximum rumter of nessages a @Queue can_ 
| store» at which point it is considered full Cmaximum 1025). 


2. «Ge FAMILY.SIZE - the number cf sub-aueues in a Queue File 


Family (maximum 1023). 


In additione Q.sB8UFFERS as descrited in the foregoing may be 
specified by the BUFFERS file attribete. Thus» the user may have 
some control cver the number cf fesseges that may be contained in 
memory at any given time. . In the CCBCL Lanquager a Queue File. 


Declaration may appear as: 


SELECT MY.@ ASSIGN TO QUEUEF. 


ED MY¥eQ VALUE OF GeMAXeMESSAGES Is 20 
RESERVE 3 ALTERNATE AREAS. 


O01 MY.Q.BUF = PIC XCec). 
SELECT MY.QFF ASSIGN TO QUEUE. 
3 es an | | 


FD MYeQFF FILE CONTAINS 2 QUEUES 
VALLE OF QeMAXe MESSAGES I5 10. 
RESERVE 2 ALTERNATE AREAS} 

(1 MY.QFF.BUF PIC X¥C#0). 


If a Queue File Family is opened» the same attributes apply to. 
every merber individually. In ¥Y.CFF above». for examples alt 
three nembers may hotd ten “messagese each having a maximum of two 
in meforye | | _ = in # 
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The frame assigned to a Queue File is specifed by the user as the 
MFID/FID combination. For a Queue File Family» the MFID is 
specified by the user and is tzken ta be the first ten 
characters» and an FID is synthesizec from the member number for. 
each queue in the family. The first member of MY.~OFF would he 


named "MY.QFEF/#00000001". 


When ¢ Queue File is cpeneds» = the MCP compares” the 20-character 
name with the names of alt Queues currently in existence. Ifa 
Queue of that name if found» the operer is lirked to the existing 
queue and tte Queue'"s user count is incremerted. If the Queue 
does rot exist» anew Queve is created with the attributes 
provided by the FP®@. Queue attriktute binding occurs when the 


Queue is first created» by the first process to open the -Queue. 


File. If two programs share a Queue (e@ege» both agree on the. 


name)de the first program to open the shared QGueue file binds the 
attrilutes. | 


Blockirg. of records is not allowed in Queue Files.e The Record 


Size attribute determines the upper limit on the Length of a 
message which may be stored in a queue file. : 


QLEVE FILE LOGICAL 140 OPERATIONS 


Queue File Logical I/O aperaticrs are rather simple and 
straightforward. As mentioned previously» all Queue Files must 


be untlecked.- Truncation or blank fill may occur» depending upon 
the size cf the user*s work area and the size of the message 
being moved» exactly as is done on att other logical I/0 
operations on £1000 systers. The user may frecuest that three 
aqifferent exception conditions be reported to him on allt Oueue 
File tcgical I/0 operations. These three ccnditions are» in 


 CesBol. eon 


i ON. ENC-OF- FILE 
* Be ON EXCEPTION» and 


4. ON INCOMPLETE-T0- 


On READ operations» END-OF-FILE is reperted to the user when the 


Queue File is empty and no prograw exists which has the Queue 
openec for output. EXCEPTION is reperted on Queue File Families 
only and on READ operations only» anc actually denotes an invatid 


key fassed on the READ to specify the desired family members — 
—INCOMPLETE-IO is repcrted if the Queue is empty but programs. 


still exist which have the Queue opened for cutput purposes= Att 
three conditions ere reported only if requested» of course. 


Failure to recuest that END“OF"FILE cr EXCEPTION be Reporesd wilt 
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be considered a program error if either condition occurs and the 
progrem will be discortinued. | _ : 


The precise meaning of EGF on READ is that Ca) the last writer on 
this Cueue has closed his Queue File end €b) the Queue is empty. 
COF is treated as a pseudo~message if the Queue. That is» when 
the last message has been read from the Queue File» the File 
still exists and actually remairs “rot empty” for WAIT purposes. 
A subsequent READ wilt result. in the ECF branch being taken. The 
Queue is then empty» but still in ECF Status» so if yet another 
READ is issued on the Queue File» the reader will again take the 
EOF branch. EQF can be cleared by either the reader closing and 
reopering the file or by the opening cf the Queue by a new 
writer. | _ | 


READS to specific wembers of a Cueuve File Family are treated 
exactly Like READs on single Queue Filese- An unspecific READ on 
a Queue File Famity will returr ECF only if all members of the 
Family are at EOF Cieee»w emptyr no writers). When the tast 
writer closes any member queue of a QFF» the. event 
QeWRITE.W OCCURRED will be caused for the FFs this wilt put a 
reader in the READY .G when it WAITS on this event. ms | 


A MESSAGE COUNT communicate atareter We. Veplenented to enable 
user crograms to determine if any messages are present in_ the 
Queue Files they are using. This functicr is described in a 
later paragraph. A MESSAGE COUNT communicate issued for a Queue 
that is marked as being at END-OFTFILE will show the EOF status 
aS a pseudo~message ~ the count for that particular Queue File 
will be one amore than the count cf real sessages. When the 
reader executes a specific REA) on tte mewber Queue which is at 
EOFs the EQF branch will be takensj The next MESSAGE-COUNT will 
show the member Queue as containing no messagese Another READ on 
the member will result in the EOF brarch being taken agers as 1s 
done for a single Queue File. : 


On Queue WRITE operationse ENO-OF- FILE is not defined ard will 


never occurs EXCEPTION has the save meaning as it does for READ 


operations - it denotes an invalid key condition on Queue File 
Families only. INCOMPLETE-10 will be reported» if requested» 
when the Queue is full and there is ro space available to. store 
the message that is being writtene If no INCOMPLETE-I0 report 15 
rquested and the Queue is full when <~ WRITE occurss the progras 
abd suspended until space is available in the Gueue. © | 


As mentioned creviousty> when a Lacical. L/a request is directed 
to a Cueue File Family» a key must te includec to idertify the 
specific Queue in the family to which the cperation is directed. 
This is similar to Switch Files in the ‘SDt Language. © Family 


: 
: 
si 


/ 
: 
: 
: 


: 
i 
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members are numbered togically frow one to fr. Giving a key of 


zero on a READ is defined as an unspecified reads The members 


will be searched» beginning with nuater one» and the first queue 
member found not empty will be reads A key of zero on a write is 
Revere | a ae 


wes 1 HE oe OES A QUEUE EILE 


Writirg tbe the pug. ee a Queue File is ‘a souess te lke MCP though 


it may or may not be allowed in a given language. A message 


written to a cueue file normally gces to the bottom of the Queue 
though some rare occurrences in apnglicaticns may require the 


converse. This capability is invoked in the communicate 
operation by setting bit 7 of CT.~ADVERE. | 


MESSAGEeCOUNT COMMUNICATE 


This communicate operation returns the count of messages in the 
Queue File specified. If a Queue File Family is specified» the 
count of each member will be returnec in an array (member one in 
the first position» member two tn the second» etce)» up to the 


Limit of the result field. Counts will be returned either in 


deciwal (COBOL “PICTURE 999") or binary CSDL “BITC24)") depending 
on the value cf the first bit of CTeAUVERB. This operation. may 
not be iggleaented in atl Languages. | | oe 


Format: | 
CT-VERB _ 48 CHEX 3302) 
CT.OBJECT File Number 
| CT-ADVERSD BY 1 Deciwat forrat results if true 
EC Tel | Result field Length in bits 


CTe2 Oo Result field address 


2000604605 04045 S064 R0ORS 


sew==—=>@ “SECOND MESSAGE TEXT™« 


| ‘ 
«ee =: 7 7 : » 882 Foe es eas DE recrerre Seer rrr rerre sts 


BE 
i BURROUGHS: CORPORATION . Fe COMPANY CONFIDENTIAL. 
ee COMPUTER SYSTEMS GROUP. i Fo | | — ~B1000 mCP ITI | 
Bi a SANTA BARBARA PLANT a 1. 7 ” — PeSe 2212 5462 (CE) | 
Reader FIE | = Writer FIB 
RERERREREREREERE a | | 4 kkk&hkkkkhhhkkkeh t 
® Device=Queue * | rk 2, ;  * Device=Queue * 
pos ie 7 * Oo : & _ « | te 
- | RRR ARKERERRERREE | Quaire Descriptor | REKKAEKEKKEKEKEREKS 
fee # Q KEY | kO HMM ODER EREERERERREADRREREE CO mma Q KEY we 
7 REREKKKKEREEKKRKK - QeLABEL="#Y.Q" « KERKKEEKERERARES 
: * Read * * Q.MAX.MESSACES=10 * * Weite « 
; *IQ Descriptor * # @Q.MSG.COUAT=3 * -->*IQ Descriptor * 
io RREEERRAREERERER - Q-3UFFERS= 2 & 1 KRKKRKAKAREEERKE 
7 | * Q.NOT.FULL=TRUE * a | | : 1d 
{ | © Q.NOTLEMPTY= TRUE * eg ee nee ee eee oe 
_ — Sees sens s eee a >e Qe FIRST oe i io 
i oe ee ~ * 2. = ° _ amma >s QeLAST | dq i i 
| : 3 . § _ 3 | : RRERREREERERR ERE | { | a | 
{1 MDL : | 3 MD2 MDZ ff | ee | 
RRRRERERRERERREM AMM DEERRE EERE REE RE EM OM OD ERERARER EE EREK EEE go4q 
* IN S“Wemory «. * On Disk ft * In Process Out * | 
fap eT gee ee ae ene = os a aeR Aaa ear ae ee! ii 
| | i MB a | 
MB 7 j Ka&RRKRKEKRAAKKKEREE 14 
RKREKRKKRAEKEKREREEREK | | # “THIRD MESSAGE «<--4 4 
| * "FIRST MESSAGE « 1 TEXT" te i 
-~ TEXT? | te i. kkhkhktek kk ehhh th hh i] 
micreerer rir tert + es ] | | | - i 
| | I Aktkkkkakkikkhkhkakkhkhhkkkkhk i 
‘i & System Disk & i 
ir SRRREREREREREEE EERE RE EM | 
“a Ss & § 
! { 
i i 
i 
i 


®t "THIRD MES>scesancce #<=== 
RRRRKEKEREERAKKEKKKAKKEERE 
a _ | | * a re 
CREA sen teen eeeme wens 


a 


‘Figure 8-12 Two Programs Communicatirg in a Queue File Called "MY.0". 
3 ess The neue contains three nessages. 
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KARR KEERKKEKKKEKAEEKKKKEE 

* "wYOFF™  — & 

*# FIE.MYUSE = INPUT/OUTPUT * 

* FIB.Q.FAMILY = TRUE. * s 
& FIB.Qe-FAMILY»-SIZE. = 3 * * 
EE REREERREKEREEEEREREKEREREE & 
* QeKEY 1 * & 
LAKE ARKRAKREEKEKARKKAKKEKKEKK & 
* Q.KEY 2 | * | 
RERAARREKRAKKERKEKEAKR ERE EERE | & 
* QeKEY 3” * 


KEE EKKKEEMREKERARKAKKAEEKERE 


& 


READ IC CESCR * 


KAR AARAEEREEKAKEREKRARKKKKAKEKKE 


® 


WRETE 10 DESCR * 


RREERAREREKERRKEEAERRAAEHERES 
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PMY. OFF" 
=##00000001 
Q.BUFFERS = 2 
- @eMAXeMESSAGES=10 
Q.MSG.CT = 0 


FIRST * LAST 


ER EREKREREMERRERAEEKEE. 


MY CF FR™ 
ng#0000C002 
— se @e BUFFERS = 2 
QeMAXoMSGCCUNT=10 
Q-MSC.CI = 1] 


KRRKEKREKKEAREKEKAEKRRERKKKS 


»» em 


te FIRST * LAST te 


RRKEMRERRERERAKRKKKKKEK SG 


khitkakhkkk&ac&kekkkk&eekk Rk akkt 


2 PMY OFFS ® 

t 742800000003 & 

t G@-BUFFERS = 2 * 

& QeMAX=oMSGeCCUNT = 10 * 

* QeMSGeCTI = 2 te WC 
KREERAREKRAEKEAEKRKAEKAEKKKEEKE RKEKEEKRARKKKEKE 
* FIRST * LAST «  & _ a 
hee aRaAKRARAAKKRKEKEKRAGCHEARKARREKEK HEEEERKEKERKERE KEKE 


Hb * » & 


MD 
KRKKEKKKREKKEKEAKE 
& : _ 4 fe 
eh eka aR KE 


MO 


kk khkakk&hkhkhkkakt 


ft  & 
RaEKKEKEKEKEKE 


Figure 8-2: A Queue~file Family with three members. 
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— INTERTPROGRAM COMMUNICATION 


Another means of accorplishing inter-process communication'is the 


Inter-Program Communication Module» first isptemented in the 9.0 

software to satisfy the requiremerts of the ANSI "74 COBOL 
languagee According to the specificétions of that lLanguager the 
facility provides synchronous CALL and EXIT verbs» as well as a 


sharec data inplementation. The mecule provides a facility to 
transfer controit from one program tc another and the ability. for 
both programs to have access to the same data items. The ‘names 


of tte programs to which control is tc be passsed may or may not 


be known at compile times. Additionallye this module provides the 


ability to determine the availability of memory for the program 


to which contrci is being passed. 


RUN UNIT DEFINIIION 


The definition of a “Run Unit" is critical to the implementation 
of the CALL/CANCEL mechanism described ir the ANSI *74 COBOL 


specifications. The execution of any program via an EXECUTE 


centrcl instruction dces not establish a Run Unite A Run Unit is 
established only wher an executed program initiates another 
program via the CALL communicate. That called program is now a 
member of the Run Unit associatec with the program that was 
originally executed. Similarly» any program called by a program 
withir the Run Unit becomes part of that Run Unit and remains in 


that Rua Unit until terminated or cancelled. A job cannot be a 


member of more thar one run unite The following figure 
represents seven programs CA - G) which have been called within a 


run uni C « 


CA was Executed) 


A 
1 | 
i <o==> Current Path 
BR. 
| me. 
bpepimue ease5 o° \ 
Path 0 ¢ 
. us = & 1 
* e } 
*F G FE 


The cennecting Links are generated by nde represent the act used 


path» ard the. link exists until a returr CEXIT PROGRAM) is. 
accosplished. Once a catted prograe@ has been exited (De Foe Ge . 
it rewains suspended in its currert states The only path that is 

of interest is the path last traversec. a aa : 
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The current path is important in crder to check the valiaity of a 
CALt or CANCEL statement> 1f a prcgram tries to CALL or CANCEL 


itself or any of its predecessors» the entire run unit will be 


DS"ed. The cther tinks are unifportant» as any program in the 
run urit can CALL or detete other existing programs» with the 
previcusly mertioned exceptions» or car CALL new programs. - | 


T fs for examples program *E" cancels program "D0" then the Run 
Unit would corsist of all of the follcwing programs and appears 
ass. | | ) _ | 


Unattached 
Programs 
fF» G 


A CALL to any of -these programs wilt result in a transfer of 


contrcl tc the existirg state» whereas a CALL to any other 


programs including "D"» witt cause an initial state copy to be 


invoked before cortrol is transferrece The termination» via STOP 
RUN cr ABORT» of any program in & Run Unit will result in the 
removal of ail programs in that Run Lrnit from semory. 


eC IMPLEMENT#IION OE SHARED DATA 


For those not familiar with the ANSI "74 COBOL definition of 
Inter-Program Communications alt programs within a Run Unit 


execute synchrcnously» No two programs in a -Run Unit may be 
executing simultaneously at any time and consequently» there are 


no preblems associated with two or mcre programs contending’ for 
the use of stared data» Contretl is passed to a program via the 


| CALL verbe The program which contains the CALL will not be 


allowed. to execute again until tre called program performs an 


EXIT PROGRAM verb. 


The calling prcogrem may specify ore cr more data items to which 


the cailed program has access- The shared data may be any 01 or 
“7 tevel item described in the catting program This’ includes 
items whose addresses have beer received through a CALL~ #£'The 


data items may be namea and defined cifferently in each program 
as tcong as the length of the item remairs the same in each 


programe This mecharism is stricly a “pass hy name” facility. | 


Parameters cannot be passed by value. Additionally» storage for 


“DE SIG SESS EERSTE EE See ee, Pe stole ee epee 2 ecg peeked Seppe 


8-12 


BURROLGHS CORPORATION COMPANY CONFIDENTIAL 
COMPLIER SYSTEMS GROUP | 81000 MCP II 
SANTA BARBARA PLANT | a3 PeS- 2212 5462 CE) 


y the shared data is never allocated ir the catted program. Kn 
other words» the address of the datz» onlye is always passed to 


the catled program. 
IPC BLN SIRVCIURE NUCLEUS CHANGES 


In order to maintain all of the necessary infcrmation regarding 
the programs which comprise a Run Unit» several fields were added 
to the Rur Structure Nucleus» RS-NUCLEUS» the field in memory 
which contairs information about each program that is executing» 


in the 9.C version of the MCP. This field» as it has always 
beenr is shared by the Operating System and the user program's 
interpreter. The following is a tist of the fields which were 


added in the 9.0 version and a brief description of each. 


RSeRUN2UNIT BIIC16) 


When z<~ job initiates a CALL» he estatlishes a RUN UNITT.j This Run 
Unit is identified by his own (Cthe criginator*s) job number. 
RSeRUNOUAT T» for any job in the Run Units» wilt contain the job 
number of the program which initiatec the Run Unit. 


a Cah aR oe «<a <a DD EE WE a ES ee ee 


This field will contain zera for the job that initiated the run 
unit and ~< for any job ir the Rur Unit that has done an EXIT 
PROGR&@M.} For any job that is currently active in the Run Unit» a 
job that thas not done an EXIT» this field with contain the job 
number of his caller. | | | | 


This field wilt contain the absolute address of the 
IPCeCICTIONARY throuch which paraweters will be accessed within 
the catiling job*s base~limit space. The fietc witt be zero if 
the cictionary does not existe Tris is the tist of parameters 
that this job will passe The ITPCeLICTIONARY is adjacent to the 
RS»NUCLELS and found onty in the calters Run Structure Nucleus. 


/ 


PEL Ur Ar PG Eat ie HE AB TC UAaR PS LEAEOAIN AE MCUs ROP SEIS AER RERUN 
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— BSsIPG*PABAMETERSLISI BIIC24) 
This field wilt contain the absolute address of the 


— TPCePARAMETER-LIST. This space wilt be adjacent to the Run 
Structure Nucleus for any called job that can receive parameters. 


The IPCePARAMETER-LIST witl be a series of 24 bit fields. The 
first field will contain the number of paraweters that this job 
is capable of receivirg. The remairing fields in the List. wilt. 


contain the length in bits of each perametere This list is built 
only fer the called program from the IPC.PARAMETER.LIST in the 
called program's code file that is gererated by the compiler. If 
the job cannot receive parameters» ttis field will contain zeroe 


RSefPCeDiCTesIZE BLICI6) 


This fietd will contain the ‘number of entries in this program's 
IPC Dictionary. | | : 


eT Te BIIL4) 


This field is used to store the type cf execution that originated. 
the jcb. If the job is not an Execute tyre or a Call type» then. 
it cannot be called. The field can cortain the following vatues: 


4d = Execute 

2 = Compite and Go _ | 

3 = Compile for Syntax 

& = Compile to Library 

5 = Compile and Save 

6 = Go Part of Conrpile and Go 

Y = Go Part of Compile and Save 
8 = Catt ye | 

BS2NAME CHARACTER (39) 


This field Witt <oncen the name of this program. In the case of 
compilations» cenoted by he value cf the previous field> it will) 
conten the name of the coer as ae | 


RERBAPPERURE eh RURET SESE s SERENE 


Ua Ue TE BE EEE 


ae ae 
a 

{ 

| 
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( BSeCALLERS a BIIC24) 


(This fietd wilt contain the Limit Recister of this job's caller. 


pe 


| RSeITPCAEVENT BIT (1) 


This field is a dummy event for zry IPC hang or suspension of 


execution. If a program is waitirg on RS-IPCe-EVENT and is 


currertly passives which will be indicated by a zero value in 
RSeRUNSUNITLINK> the RSe«STATUS witl be set to a vatue_ to 
indicate “Waiting to be Catled™. If the program is currently 


actives indicated by a non-zero vatue in RSsRUNUNIT.LINK» the 


RSeoSTATUS witt be set to a value ircicating "Waiting on cailed 
progrzem" 


 ES2lANCELEL BIiti) 


if this boolean is true» then at least one CANCEL communicate has 
been issued against this prografa When this is trues this 
particular job is effectively no loncer a member of the Run Unit 


and 1s wattine to be terminated by the SMCP. 


IPC Program Parameter Block Changes 


‘ 
! 
i 
t 
H 


It was also necessary to make charges in the Program Parameter 
Blocks the twomsector field that is generated by the compiters 
and stared in the code files to accomodate the IPC 


teplesentation. A tist of the fielcs that have been added is 


presented below. 
PROGeIPCsSIZE BIIC16) 


This field indicates the  numter of entries in the 


TPC.PARAMETER.LIST. If this field is not ecual to zero» it 


indicetes to the MCP that this prcecram can orly be called -= tt 
can. never be EXECUTEd. 3 


Ds BLES ERED REE ject bee ehegee Ege 


Ne SR SD a aed Pike EY Big a te Spear bakeio te Lies 
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- -PROGsIPC2FIR 811624) 


vac field is used to store the relative disk address in the code 


file cf the TPC.PARAMETER.LIST. The TPCePARAMETER.LIST will be a 


series of 24 tit, fields that contain the Length in bits of the 
parameters that may be passed to this Eroaree with a CALL. 


| PROGSIPE SPAN SEND s PARAMS 817016) 


eee we «me ae en Phe ee Oe oe oe oe BO 


‘This field indicates the maximun number of parameters to be 


passed by this program through a CALL» which wilt also be_ the 


number of entries in the [PC Dictionarys 


it was also necessary to add a field tc the fermat of the Program 


Parameter Block that is used by the MCP after the job is. 


scheduled for executicne This fielc» known as PPBeRUNOUNTT» 15 


sixteen bits in Length and is used tc contain the Job number of 
the run unit that this orogram witl tecome a part of. 


‘The eateetanan’ ds a list of System Descriptors built by the 
program to describe the parameters tec be passed on a CALL-e This — 


dicticnary wilt te within the snace cefined by RSIPC. DICT in the 
RSeNUCLELS of the calling prograse the Length of this dictionary 
is passed in the CALL communicate. The Micro MCP will verify 
that the number and tength of pérameters passed match the 
TIPCoPARAMETER.LIST of the cailed procram. 


REM PRRT SISO LEA CEU ROSY TNE SO RUE ESR EUR IM A MERCER AN SOLU Ne ee 
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IPC COMMUNICATE oeegator | 


One new communicate cperator was addec to the Operating System to 
accomcdate the IPC implementation. Ibis operator is generated by 
the Compilers to implement the CALL» CANCEL and EXIT PROGRAM 
yerbSe It may be hardted ty the “icro MCP or the SOL MCP ep 
depending upon the circumstances es. Its corner. is presented below 
and in “£ns Demand Maragement section. 


— CTAVERB 43 

CT.GORJECT 0 = CALL 

| | 1 = CANCEL 

| 2 = EXIT. PROGRAM CNo EQS) 
CTw~ADVERE F.% Bit 
. | C - if CALL» return on NO MEMORY 
| I-11 = Net used a 
CT.1 7  ° Base relative address of a 39 character 


field that contains the name of the job 
| te he caited or cancelled. | | 7 
CTi.2 | | | Number of parameters to be passed 


RSeREINSTATE*MSUG.PIR values returnec If reouested: 


0 = Communicate completed as recuested. 
1 * For CALL» insufficient mesory to complete the CALL. 
~ For EXIT PROGRAM,» the procram was initiated by an 
EXECUTE instruction as opgesed to a CALL- 
- Not used for CANCEL. | 


Ipc Verb Operation 


One of the primary otjectives of the IPC implementation was 
performance.- Therefore» as much as pessible cf the IPC function 
was implemented in the Micro MCP. In the ANSI "74 COBOL 
Languege» the CALL ard CANCEL verbs require the specification of 
prograa names within the source text.« On the 81000 systems the 
name of 4 program may be unknown te the user when the program 15 
compiled» since the Run Unit may be executed under a Usercode. 


To sie@plify the task of associating program names with those 
Specified by a program in a CALL cr CANCEL communicate» a new 
system structure was implemented. A programmatic description of 
the structure» IPC. RUN- UNIT.LIST» is presented below | 
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01 IPC RUNJUNIToLIST BITC320)5 
O2 IPC»RUN-UNIT»NUMBER BIT C16)> 
02 IPC.PGMeNAME CHARC30)> 
02 IPC.PGM.JOB.NUMBER BIT (16)> 


02 IPC. FORWARD.LINK | BIT €24)3 


IPCeRUN»eUNITeLIST is a tLinked serial list which includes att 
members of all Run Unitse The entries in this list aren*t in any 
particular order and are not grcuped by Run Unite The SOL 


portion of the MCP is responsible for the management = and 


maintainence of akt = [PC.RUN.UNIT.LISTs. The first 
IPCoRUNeUNIT.LIST is addressed by a field in the MCP*"s~ stack. 
acth the S»MCP and the Micro MCP (M.MCP). access these structures 
for informsetian. 


IPC CALL OPERATION 


The MICRO MCP receives. all CALL commuricatess Any named job is 
considered a candidate for a CALL by the Micro MCP. If the 


requested job is not currently a member of the correct Run Units 


then the CALL request will be transferred from the Micre MCP to 
the SCL portion of the MCPr to make the callec program present. 


Jo determine if the peGusewed sidk is 2 member of the correct Run 


Units the Micro MCP searches the tist of Rur Units» beginning 


with the firsts» which is addressed ty a field in the MCP stacks» 
Each program that is a member of ery Run Unit wilt be found in 
the seriaily tink list described by the . TPCeRUN-UNTT.LIST 
structuree : Ss ee ee _ 


If the program is present» the Micre MCP will first examine the 
progréew’s RSeCANCELED boolean in its Run Structure Nucleus. If 
this boolean is trues then this copy of the program has been 
cancelled and a new copy must be initiated. CANCEL operationse 
Like. all program termination  cperaticns do not happen 


 immeddatety. If a new copy must be initiated» the Micro MCP will 
call the SeMCP to initiate <@ new copy cf the same program. S.MCP 


opefationss upon eee nd: a CALL ccwmunicate» are described in 


later paragraphs. 


iif Ss ee bem toolean is false» then the Micro MCP checks 


to determine whether the catled job is active or passives which 


will be indicated ky the RSsRUN-UNIT.LINK field of the Run — 
“Structure Nucleus. If the jab is estlready active» then some 


theoretically impossible error has occurred and the Micro MCP 


must call the S.MCP so that the Run Lrit can be terminated. it~ 


sh ee ar Ms ah oa» 6 * a Fg | MNEN eh 9 SRE ais SRT Ig ag cera ee Ree 2 BP ig FE ae Poa Bs a i ee ad PP Oe ie A Ce ed Fae ee ge tae oe no he eds ee gh ar a te OT ee Bie Te OR) Se SO 
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the. called program 1s found tc be passives then the Micro MCP 


will next check to insure that the rumber of parameters to be 


 passede if any» agreee This will te indicated by the calling 
-progrem*®s RSsTPC.DICT field peang ecual to the called program's 


ole PPRAMETER- cers 


eee number. a “parameters ie not matchs then the Micro MCP 


calls the SeMCP for termination of the run unite Tf the number 
of parameters do agrees the Micro MCF next checks. to insure that 
the Length specified for each passed parameter is the same in the 


callirg program and the called prcegrame If any of the length 
cescriptions are not equal» the Micre Mcp willl col: the S-MCP for 


termiration of ve entire Run Unite 


io nieaanies ere being passed» if the au aber of parameters is 


equal and if they atl have equal length attributes» then in the 
caltlirg program's Run: structure Nucteus» the Micro MCP increments 


the RS~TEMPORARY.FREEZE field» to fix the program in memory and 


sets the RS~RUN-UNITSLINK field to the caller's job number. In 
the Run Structure Nucleus of the catied job» it sets. the 
RSeCALLERS.LR field to the Limit register of the calling program. 
It then hangs the calling program or its RS-IPCJEVENT field and 


sets the caller's RSeSTATUS fielc to “waiting on the called 
prograg" and marks the cailed job “ready to run". [It should be 
noted that it is. not necessary to freeze the- calling i ly in. 


epenry if Pondsetone are not passede 


Consicerirg the case where the callec program is not a member of 
the Run Unit and the S-eMCP is called upon to execute the 
requested procram» whenever the S. MCP receives a CALL communicate. 
and usercodes are involved» it will first search the list of Run 
—Unitse using atl permutations of the usercoded names to determine 
af the job exists in the Run Unit urcer a different name. if so» 
the new name and corresponding inforaation willbe entered into 
the fun Unit List and cortrol witl te returned to the Micro MCP. 


If Usercodes are not involved anc if the name does not exist in 


the Run Lnit List» then execution of the job nust be attempted. 


The &.MCP aust then determine treat the requested precgrar is 


present an disk.» If not present» the program which issued the 
CALL will be hung until the recuested program is made present. 


If the requested orogram is present cr diske the SeMCP must then 


detersine that there ts enough meaory to execute the requested 
prage If there is insufficient senory>» The program which 
perfcrmed the CALL may have asked to be. notified of this fact. 
If so» the catled jot will rot be scheduled but the program which 


performed the CALL witt be notified cf the insufficient memory 


condition. If the program which performed the CALL did not. 


request to be nofitied» the catled program will be scheduled and 
the Colheng: peegnes wilt not te allcwed to. execute until the 
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callec prograr does ar EXIT PROGRAM communicate. 


Keuatys after the calted program reaches BQJ» the Se-MCP will 

hang the calltec program on his own RSIPCAEVENT with RS-STATUS 
set te “*haiting to be catled" and put the calling program back in 
the w.COMM.Q. This altows the Micre MCP to complete the CALL 
operatian. - . Oe a 


IPC CANCEL OPERATION 


are handted ty the Micro MCP. Upon receivine a CANCEL operators 
the icro MCP must first determine if the job exists in the Run 
Unit end whether it 18 active or fassivee If it is not present 
or the program is present but its RSeCANCELED boolean is trues 
the request is ignored: and the cancelling job is reinstated. If 

it is presert and passive» the Picro MCP will then place the 
specified program in the EXTERMINATE.Q> set the RS.-CANCELED 


boolean and returr control to the job which issued the 
communicate. The EXTERMINATE.9 will cause termination of the 


yobe 


biel 


A recuest to CANCEL a job that is tcth a meaber of the Run Unit 
— in termination of the entire Kun Unit. — 
és dia jcb soa ua dab elds communicate operations the 
Micro MCP will harg the issuing epregram or its RS-IPC.EVENT 


RSeTEWPORARYsFREEZE in the Run Structure Nucleus of the program 
that catled the issuing program and mark the calling prograa 


communicates the communicate will be ignored and controt will be 
a ee Cae to that orograr. - ? : 
“dee LERHINATION ‘SauSs IDER ations 
| en SrpsTae in a Run Unit perforss a STCP RUN communitcate 
operators the entire Run Unit wilt Ee cancettec and all programs 


in tke Run Urit terminates abnormally» the entire Run Unit will 


- be discontinued. Programs within é& Run Urit may onty stop 
execution via the EXIT PROGRAM vert. Normat termination will 


occur when the program that initiatec the Run Unit terminates. © 


SANTA BARBARA PLANT | | | P.S. 2212 5462 CE) 


ALL espects of the CANCEL and EXIT PROGRAM ccmaunicate opertors 


and active is a violation of the CCRBCL specifications and witt> 


field» setting RS~STATUS to “Waitirg to be catled*» decrement 


ready to run. If a program that was not catled issues the 


in the Run Unit will be discontinued. Similarty» if any program | 


Nien hres ewes 
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Upon termination» for any reasons cf any member of a particular 
Run | Unit» the S.MCP witil immeciately detink att entries 


pertaining to the specified Run Unit from the Run Unit Liste 


When the parent of a Run Unit goes tc anormal EQS» then all jobs 
attached to that run unit will be cancelled» If any job in a run 
unit is eborted» then the entire rur unit will be aborted. If 
one program in a Run Unit does a CANCEL on another program in the 
same run units» then the cancelled dct must te° delinked from the 
run urit and sent to f£OJ. : 


The transfer of information between the Micro MCP and the S.MCP 
is accoaplished usirg an existire mecharisme This mechanisa 
utilizes the Run Structure Nucleus tield»s RSeMePROSLEM.  #£ALT 
instarces of such required commurication are shown in the 
follewinrg table. The table shows tte value that will be stored_ 
im the RSeMPROB.PZ = fields a subfield of RSeMsPROBLEM»~ the 
condition that caused the communication and the action that will 
be taken by the SeMCP. Whenever such communication is necessary» 
the RS-MPROB.P1 field» also a subfielc» will be set to a value of 
oe which will indicate the Maney of fFroblems related to IPC. 


RS eMPROB.P2 = 7 Error Descrirtion | Required Action 
0 Z Heauested progrem not SeMCP should make 
| not if Mixes | program present. 
i Number of parameters S.MCP will CS entire 
- | do not matche . Run Unit. 
2 é Parameter specs. —  -  § eMCP will DS entire 
| do not agree. on Run Unit. | 
3 | Attempted recursive | SeMCP will DS entire 
. CALL | | Run Unite. 
4 Attempted CANCEL |= —- S-MCP will DS entire 
of predecessore Run Unite 
3 | Invalid Communicate | SeMCP will DS entire 
| parameters. a ee Run Unit. 
6 — Found requested job | Terminate specified 


and RS.CANCELEC true job and make new 
| | copy presente 


tetas aes fame meyhne: ty te fac at ayche ag meneame ned ye tar an ecront wei ee Mann os mens cok eae om “orn Aone os oA ogee oat SEE Ca Bos os 
ae Pak Wee SOUT Seibel Re AU RGR aa 
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LPC PROSHAM DLPPS 


If ary member of the Run Unit» regardtess of whether the 
specified prooram is active or nassive is DS"ed» DP~eds or DM~ed» 
the entire Fun Unit will be dunared and» if DS~ed or DP-ede 
termirated. | 


IfC CANDIDATES FOR ROLL-QUT 


After the Micro MCP processes an TPC communicates Tt wilt not 
purpcsely mark the appropriate jet YO.BE-ROLLED.OUT. It the 
SoMCP needs memoryr it will follow the normal selection process 


in determinirg a candidate(€s) for Rell~out.~ There witli be no 


special consideration given to nembers of Run Units. 
TPC TASK CONSIDERATIONS 


Each cattled program will actually becore a. TASK associated with 


the originator of the Run Unit. By Eecoming a TASK as opposed to 
a normal job» several advantages will be realized. 


4) TASKS are not subject to MIX Limits ard other scheduling 
constraintse — | | | 
2} There will be correspondirg ertries ir the SYSTEM/LOG. 


RUEID AOE SEA ae “EN wee 


Information passed for the programs name in the CALL/CANCEL 
communicate will be subject to the same naming restrictions as a 
file with respect to CS or BP conditicrss e«ge» CALLing a program 
with .a blank MFIO wilt result in the termiration of the entire 
Run Urite | | 
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